Visio) (Application.EventInfo 屬性

會取得與某事件相關的額外資訊 (如果有)。 唯讀。

語法

運算式EventInfo (EventSeqNum)

expression 代表 Application 物件的變數。

參數

名稱 必要/選用 資料類型 描述
eventSeqNum 必要 Long visEvtIDMostRecent (0) ,以取得最近引發的事件的相關資訊,或要檢查的事件序號 (請參閱 VisEventCodes) 。

傳回值

字串

註解

當 Microsoft Visio 引發事件時,有少數的事件會提供詳細資訊。 這些事件為 BeforeDocumentSaveAsDocumentSavedAsEnterScopeExitScopeMarkerEventShapesDeletedShapeChanged。 使用應用程式的 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 支援與意見反應