Table of contents
TOC
Recolher sumário
Expandir sumário

Propriedade Application.EventInfo (Visio)Application.EventInfo Property (Visio)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

Obtém informações adicionais associadas a um evento, caso existam. Somente leitura.Gets additional information associated with an event, if any exists. Read-only.

SintaxeSyntax

expressão . EventInfo ( eventSeqNum )expression . EventInfo( eventSeqNum )

expressão Uma variável que representa um objeto Application .expression A variable that represents an Application object.

ParâmetrosParameters

NomeNameObrigatório/opcionalRequired/OptionalTipo de dadosData TypeDescriçãoDescription
eventSeqNumeventSeqNumObrigatórioRequiredLongLongvisEvtIDMostRecent (0) para obter informações sobre o evento acionado mais recentemente ou o número de sequência do evento a ser examinado.visEvtIDMostRecent (0) for information about the most recently fired event, or the sequence number of the event to examine.

Valor retornadoReturn Value

StringString

ComentáriosRemarks

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 a e ShapeChanged . Use a propriedade EventInfo do aplicativo para obter essas informações, quando estiver disponível.When Microsoft Visio fires an event, there are a small number of events for which additional information is available. These events are BeforeDocumentSaveAs , DocumentSavedAs , EnterScope , ExitScope , MarkerEvent , ShapesDeleted , and ShapeChanged . Use the application's EventInfo property to obtain this information, when available.

A propriedade EventInfo retorna o seguinte:The EventInfo property returns the following:

  • Uma cadeia de caracteres cujo conteúdo é específico para o evento em questão, caso o evento registre informações adicionais.A string whose contents are specific to the event in question, if the event does record extra information.

  • Uma cadeia de caracteres vazia, se um evento não grava informações extras.An empty string if an event does not record extra information.

  • Um erro, se o Microsoft Visio não tiver mais informações sobre o evento específico.An error if Visio no longer has information for the specified event.

Para obter detalhes sobre o conteúdo da propriedade EventInfo para um evento, consulte o tópico do evento específico.For details about the contents of the EventInfo property for an event, see the specific event topic.

Se um destino de evento consultar a propriedade EventInfo imediatamente após sendo acionado, o evento mais recente e o evento cujo número de sequência foi passado para o destino são os mesmos. No entanto, se o destino for um complemento implementado por um arquivo executável (.exe), isso pode não ser o caso, porque o arquivo executável e o Visio são tarefas separadas que não estejam modais com relação umas às outras.If an event target queries the EventInfo property immediately after being triggered, the most recent event and the event whose sequence number was passed to the target are the same. However, if the target is an add-on implemented by an executable (.exe) file, this may not be the case, because the executable file and Visio are separate tasks that aren't modal with respect to each other.

Observação Manipuladores de evento que utilizam o Microsoft Visual Basic for palavra-chave Applications (VBA) WithEvents têm acesso a somente o evento mais recente e devem usar visEvtIDMostRecent .Note Event handlers that use the Microsoft Visual Basic for Applications (VBA) WithEvents keyword have access to only the most recent event and must use visEvtIDMostRecent .

Para garantir que as informações retornadas pela propriedade EventInfo estão associadas com o mesmo evento que disparou o complemento, o arquivo executável pode passar como um argumento para a propriedade EventInfo . Você pode obter o número de sequência de um evento das seguintes maneiras:To ensure that the information returned by the EventInfo property is associated with the same event that triggered the add-on, the executable file can pass as an argument to the EventInfo property. You can obtain the sequence number of an event in the following ways:

  • Se a propriedade Action do objeto Event retornar visActCodeRunAddon , a cadeia de caracteres de linha de comando passada para o complemento conterá uma subcadeia do formulário "/ eventid =".If the Action property of the Event object returns visActCodeRunAddon , the command line string passed to the add-on contains a substring of the form "/eventid=".

    Observação Mesmo que a subcadeia de caracteres está rotulada "/ eventid," não confunda o passada na sequência de linha de comando com a propriedade ID do disparo do objeto Event , que identifica o objeto de evento na sua coleção EventList . O número que está sendo passado é realmente o disparo número de sequência.Note Even though the substring is labeled "/eventid," don't confuse the passed in the command line string with the ID property of the firing Event object, which identifies the Event object in its EventList collection. The number being passed is actually the firing sequence number.

  • Se a propriedade Action do objeto Event retorna visActCodeAdvise , o número de sequência é passado como um argumento para o procedimento VisEventProc implementado pelo objeto de destino.If the Action property of the Event object returns visActCodeAdvise , the sequence number is passed as an argument to the VisEventProc procedure implemented by the target object.
© 2018 Microsoft