Propriedade Application.EventInfo (Visio)

Obtém informações adicionais associadas a um evento, caso existam. Somente leitura.

Sintaxe

expressão. EventInfo (eventSeqNum)

expressão Uma variável que representa um Aplicativo objeto.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
eventSeqNum	Obrigatório	Long	visEvtIDMostRecent (0) para obter informações sobre o evento disparado mais recentemente ou o número de sequência do evento a ser examinado (consulte VisEventCodes).

Valor de retorno

Cadeia de caracteres

Comentários

Quando o Microsoft Visio dispara um evento, há um pequeno número de eventos para os quais informações adicionais estão disponíveis. Esses eventos são BeforeDocumentSaveAs, DocumentSavedAs, EnterScope, ExitScope, MarkerEvent, ShapesDeleted e ShapeChanged. Use a propriedade EventInfo do aplicativo para obter essas informações quando estiver disponível.

A propriedade EventInfo retorna as seguintes informações:

• Uma cadeia de caracteres cujo conteúdo é específico para o evento em questão, caso o evento registre informações adicionais.

• Uma cadeia de caracteres vazia, se um evento não grava informações extras.

• Um erro, se o Microsoft Visio não tiver mais informações sobre o evento específico.

Para obter detalhes sobre o conteúdo da propriedade EventInfo para um evento, consulte o tópico do evento específico.

Se o destino de um evento consultar a propriedade EventInfo imediatamente após ser acionado, o evento mais recente e o evento cujo número de sequência foi enviado para o destino serão os mesmos. Entretanto, se o destino for um complemento implementado por um arquivo executável (.exe), isso poderá não acontecer, porque o arquivo executável e o Visito são tarefas separadas que não são restritas com relação uma a outra.

Observação

Os manipuladores de eventos que utilizam a palavra-chave WithEvents do Microsoft Visual Basic for Applications (VBA) só têm acesso ao evento mais recente e devem necessariamente utilizar visEvtIDMostRecent.

Para garantir que as informações retornadas pela propriedade EventInfo sejam associadas ao mesmo evento que acionou o complemento, o arquivo executável pode passar <sequence number> como um argumento para a propriedade EventInfo . Você pode obter o número de sequência de um evento das seguintes maneiras:

• Se a propriedade Action do objeto Event retornar visActCodeRunAddon, a cadeia de caracteres de linha de comando passada para o complemento conterá uma subconserção do formulário "/eventid=<sequence number>".

  Embora a substring seja rotulada "/eventid", não confunda o <sequence number> passado na cadeia de caracteres de linha de comando com a propriedade ID do objeto Evento de disparo, que identifica o objeto Event em sua coleção EventList . O número passado, na verdade, é o número de sequência do acionamento.

• Se a propriedade Action do objetoEvent retornar visActCodeAdvise, o número de sequência será passado como um argumento para o procedimento VisEventProc implementado pelo objeto de destino.

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.