InvisibleApp. EventInfo-Eigenschaft (Visio)InvisibleApp.EventInfo property (Visio)

Ruft zusätzliche Informationen zu einem Ereignis auf, sofern vorhanden.Gets additional information associated with an event, if any exists. Schreibgeschützt.Read-only.

SyntaxSyntax

Ausdruck. EventInfo (eventSeqNum)expression.EventInfo (eventSeqNum)

Ausdruck Eine Variable, die ein InvisibleApp -Objekt darstellt.expression A variable that represents an InvisibleApp object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
eventSeqNumeventSeqNum ErforderlichRequired LongLong visEvtIDMostRecent (0) Informationen zum zuletzt ausgelösten Ereignis oder zur Sequenznummer des zu untersuchenden Ereignisses (siehe VisEventCodes).visEvtIDMostRecent (0) for information about the most recently fired event, or the sequence number of the event to examine (see VisEventCodes).

RückgabewertReturn value

ZeichenfolgeString

BemerkungenRemarks

Wenn ein Ereignis von Microsoft Visio ausgelöst wird, stehen für einige wenige Ereignisse zusätzliche Informationen zur Verfügung.When Microsoft Visio fires an event, there are a small number of events for which additional information is available. Zu diesen Ereignissen gehören BeforeDocumentSaveAs, DocumentSavedAs, EnterScope, ExitScope, MarkerEvent, ShapesDeleted und ShapeChanged.These events are BeforeDocumentSaveAs, DocumentSavedAs, EnterScope, ExitScope, MarkerEvent, ShapesDeleted, and ShapeChanged. Verwenden Sie die EventInfo -Eigenschaft der Anwendung, um diese Informationen zu erhalten, wenn verfügbar.Use the application's EventInfo property to obtain this information when available.

Die EventInfo-Eigenschaft gibt Folgendes zurück:The EventInfo property returns the following:

  • Eine Zeichenfolge, deren Inhalt nur für das jeweilige Ereignis gilt, sofern für dieses Ereignis Zusatzinformationen aufgezeichnet werden.A string whose contents are specific to the event in question, if the event does record extra information.

  • Eine leere Zeichenfolge, sofern ein Ereignis keine Zusatzinformationen aufzeichnet.An empty string if an event does not record extra information.

  • Einen Fehler, wenn Microsoft Visio keine Informationen zu dem angegebenen Ereignis mehr enthält.An error if Microsoft Visio no longer has information for the specified event.

Ausführliche Informationen zum Inhalt der EventInfo-Eigenschaft eines Ereignisses finden Sie im Thema zum entsprechenden Ereignis.For details about the contents of the EventInfo property for an event, see the specific event topic.

Wenn die EventInfo-Eigenschaft von einem Ereignisziel direkt nach dem Auslösen abgefragt wird, ist das zuletzt ausgelöste Ereignis mit dem Ereignis identisch, dessen Sequenznummer an das Ziel übergeben wurde.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. Dies ist jedoch nicht der Fall, wenn es sich bei dem Ziel um ein Add-On handelt, das von einer ausführbaren Datei (EXE) implementiert wurde, da die ausführbare Datei und Visio separate Aufgaben darstellen, die nicht aneinander gebunden sind.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.

Hinweis

Ereignishandler, die das VBA-Schlüsselwort (Microsoft Visual Basic für Applikationen) WithEvents verwenden, können nur auf das letzte Ereignis zugreifen und müssen visEvtIDMostRecent verwenden.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.

Um sicherzustellen, dass die von der EventInfo -Eigenschaft zurückgegebenen Informationen demselben Ereignis zugeordnet sind, das das Add-on ausgelöst hat, kann <sequence number> die ausführbare Datei als Argument an die EventInfo -Eigenschaft übergeben werden.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 <sequence number> as an argument to the EventInfo property. Sie haben folgende Möglichkeiten, die Sequenznummer eines Ereignisses zu erhalten:You can obtain the sequence number of an event in the following ways:

  • Wenn die Action -Eigenschaft des Event -Objekts visActCodeRunAddonzurückgibt, enthält die Befehlszeilenzeichenfolge, die an das Add-on übergeben wird, "/eventid=<sequence number>"eine Teilzeichenfolge des Formulars.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=<sequence number>".

    Auch wenn die Teilzeichenfolge beschriftet "/eventid"ist, verwechseln Sie <sequence number> nicht die übergebene Befehlszeilenzeichenfolge mit der ID -Eigenschaft des auslösende Ereignis Objekts, das das Event -Objekt in seiner EventList -Auflistung identifiziert.Even though the substring is labeled "/eventid", don't confuse the <sequence number> passed in the command-line string with the ID property of the firing Event object, which identifies the Event object in its EventList collection. Bei der übergebenen Nummer handelt es sich um die Nummer der Auslösesequenz.The number being passed is actually the firing sequence number.

  • Wenn die Action-Eigenschaft des Event-Objekts visActCodeAdvise zurückgibt, wird die Sequenznummer als Argument an die vom Zielobjekt implementierte VisEventProc-Prozedur übergeben.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.

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.