propriedade Event.ID (Visio)

Obtém a ID de um objeto. Somente leitura.

Sintaxe

expressão. ID

Expressão Uma variável que representa um objeto Event .

Valor de retorno

Long

Comentários

A ID de uma forma é única apenas dentro do escopo da página ou mestre. A ID de uma página, um mestre ou um estilo é única dentro do escopo do documento.

Se uma forma, página, mestre ou estilo forem excluídos, os futuros objetos no mesmo escopo poderão receber a mesma ID. Portanto, persistir IDs de formas ou estilos em repositórios de dados separados geralmente não é um procedimento tão confiável quanto persistir IDs exclusivas, usando a propriedade UniqueID.

Para objetos Shape, você pode usar a propriedade ID com métodos como GetResults e SetResults para obter ou definir vários valores de células de uma vez, possivelmente células de várias formas diferentes. Para fazer isso, você deve passar IDs de forma aos métodos. Se você cria formas usando o método DropMany, ele retorna as IDs das formas criadas no seu programa.

Nos objetos Font, a propriedade ID corresponde ao número armazenado na célula Fonte da linha na seção Propriedades do Caractere da forma. Por exemplo, para aplicar a fonte chamada "Arial" ao texto de uma forma, crie um objeto Font que represente "Arial", obtenha a ID dessa fonte e, em seguida, defina a propriedade CharProps do objeto Shape com essa ID.

A ID associada a uma fonte específica varia entre diferentes sistemas ou quando outras fontes são instaladas ou removidas de um mesmo sistema.

Para objetos Window , a propriedade ID pode ser usada com a propriedade ItemFromID de uma coleção do Windows para recuperar um objeto Window da coleção sem iterar por meio da coleção. Um objeto Window cuja propriedade Type está definida como visAnchorBarBuiltIn retorna uma ID de visWinIDCustProp, visWinIDDrawingExplorer, visWinIDFormulaTracing, visWinIDMasterExplorer, visWinIDPanZoom, visWinIDSizePos ou visWinIDStencilExplorer. Um objeto Window cuja propriedade Type está definida como visAnchorBarAddon retorna uma ID exclusiva em sua coleção windows para o tempo de vida dessa coleção. Se um objeto Window tiver uma ID visInvalWinID, você não poderá usar a propriedade ItemFromID para recuperar o objeto Window da sua coleção.

Nos objetos Event, a propriedade ID identifica de maneira exclusiva um objeto Event em sua coleção EventList. Enquanto uma referência for mantida em uma coleção EventList ou no objeto de origem de uma coleção EventList, você poderá armazenar em cache a propriedade ID de qualquer objeto Event da lista. Mesmo que outros eventos sejam adicionados ou removidos da lista, a ID armazenada em cache poderá ser utilizada posteriormente para identificar o evento original. Se um evento for persistente, sua ID poderá ser armazenada em cache indefinidamente. Embora o evento designado pela ID possa ser removido, nenhum objeto Event novo receberá essa ID na mesma coleção EventList.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.