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.