Visio) (Application.EventInfo 屬性
會取得與某事件相關的額外資訊 (如果有)。 唯讀。
語法
運算式。EventInfo (EventSeqNum)
expression 代表 Application 物件的變數。
參數
名稱 | 必要/選用 | 資料類型 | 描述 |
---|---|---|---|
eventSeqNum | 必要 | Long | visEvtIDMostRecent (0) ,以取得最近引發的事件的相關資訊,或要檢查的事件序號 (請參閱 VisEventCodes) 。 |
傳回值
字串
註解
當 Microsoft Visio 引發事件時,有少數的事件會提供詳細資訊。 這些事件為 BeforeDocumentSaveAs、DocumentSavedAs、EnterScope、ExitScope、MarkerEvent、ShapesDeleted 及 ShapeChanged。 使用應用程式的 EventInfo 屬性在可用時取得這項資訊。
EventInfo 屬性會傳回下列資訊:
如果事件有記錄額外的資訊,會傳回內容與特定事件相關的字串。
如果事件沒有記錄額外的資訊,會傳回空字串。
如果 Visio 不再有指定之事件的資訊,會傳回錯誤。
如需事件的 EventInfo 屬性的內容詳細資訊,請參閱特定的事件主題。
如果事件目標在觸發後立即查詢 EventInfo 屬性,則最新的事件以及序號已傳送到目標的事件是相同的。 不過,如果目標是由可執行檔 (.exe) 實作的附加元件,這兩種事件就可能不是相同的,因為可執行檔和 Visio 是不同的工作,彼此不會有強制關係。
注意事項
使用 Microsoft Visual Basic for Applications (VBA) WithEvents 關鍵字的事件處理常式只能存取最近的事件,而且必須使用 visEvtIDMostRecent。
為了確保 EventInfo 屬性傳回的資訊與觸發附加元件的相同事件相關聯,可執行檔可以做為引數傳遞 <sequence number>
至 EventInfo 屬性。 您可以用下列方式取得事件的序號:
如果Event物件的Action屬性傳回visActCodeRunAddon,則傳遞至附加元件的命令列字串會包含格式
"/eventid=<sequence number>"
的子字串。即使子字串標示為
"/eventid"
,請勿將命令列字串中傳入的 與引發Event物件的ID屬性混淆<sequence number>
,該物件會識別其EventList集合中的Event物件。 傳遞的數位實際上是引發序號。如果 Event 物件的 Action 屬性傳回 visActCodeAdvise,則序號會以目標物件所實作的 VisEventProc 程序的引數形式傳送。
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。