共用方式為


協助工具工具 - AccEvent (無障礙事件監看員)

AccEvent (Accessible Event Watcher) 可讓開發人員和測試人員在 UI 變更時驗證應用程式的 UI 元素是否引發適當的 Microsoft 消費者介面自動化 和 Microsoft Active Accessibility 事件。 當焦點變更,或叫用、選取 UI 元素或具有狀態或屬性變更時,可能會發生 UI 中的變更。

AccEvent 會隨 Windows 軟體發展工具組 (SDK) 一起安裝。 它位於 SDK 安裝路徑的 \bin\ < version > \ < platform > 資料夾中(Accevent.exe)。

注意

AccEvent 是舊版工具。 建議您改用 協助工具深入解析

需求

AccEvent 可用來檢查沒有消費者介面自動化之系統上的協助工具資料,它原本是針對 Microsoft Active Accessibility 所撰寫。 若要檢查消費者介面自動化,消費者介面自動化必須存在於系統上。 如需詳細資訊,請參閱消費者介面自動化 一節。

AccEvent 會安裝為 Windows SDK 中整體工具集的一部分,不會以個別的 exe 下載方式散發。 Windows SDK 包含本節記載的所有協助工具相關工具。 取得 Windows SDK。 (如果您需要舊版,也有從該頁面連結的 SDK 下載封存。

若要執行 AccEvent ,請在 \bin\version > \ < < platform > 資料夾中尋找 AccEvent.exe 並加以執行(您通常不需要以系統管理員身分執行)。

可存取的事件監看員視窗

當您啟動 AccEvent 時,會顯示主視窗。 主要 AccEvent 視窗會顯示執行中應用程式所引發消費者介面自動化或 Microsoft Active Accessibility 事件。 主視窗有下列主要部分:

  • 標題列。 顯示目前的作業模式和狀態。
  • 功能表列。 提供 AccEvent 功能的存取 權。
  • 資料檢視。 顯示每個事件的相關資訊,包括引發事件之 UI 元素的事件識別碼和選取的屬性。

AccEvent 只有圖形化使用者介面;此工具沒有命令列引數,但您可以使用其他工具來將輸出記錄檔當作文字來處理。

下圖顯示主要 AccEvent 視窗。

the user interface for the accessible event watcher tool

可存取的事件監看員工作

本節包含常用 AccEvent 工作的相關資訊。

設定作業模式

您可以使用 [ 模式 ] 功能表來設定 AccEvent 作業模式,然後選取控制工具行為的設定。 您可以選取下列選項。

選取此選項時 AccEvent 會執行此工作
一律在最上芳 出現在畫面上任何其他使用者介面的頂端。
UIA 事件 顯示消費者介面自動化事件的相關資訊。
WinEvents (內容中) 顯示傳遞至伺服器位址空間中連結函式之 Microsoft Active Accessibility 事件 (WinEvents) 的相關資訊。 如需詳細資訊,請參閱 內容攔截函式
WinEvents (內容不足) 顯示傳遞至用戶端位址空間中連結函式之 Microsoft Active Accessibility 事件 (WinEvents) 的相關資訊。 如需詳細資訊,請參閱 內容外攔截函式
顯示醒目提示矩形 反白顯示引發所選事件的 UI 元素周圍的矩形。
顯示資訊工具提示 在工具提示中顯示事件資訊。
設定 顯示 [UIA 事件設定 ] 或 [WinEvent 設定 ] 對話方塊。

 

篩選消費者介面自動化事件

若要設定 [AccEvent] 視窗中顯示的 消費者介面自動化事件和屬性,請按一下 [模式 ] 功能表,選取 [UIA 事件 ],然後選取 [設定 ]。 [ UIA 事件設定 ] 對話方塊隨即顯示。 您也可以使用此對話方塊來篩選事件。

[ UIA 事件設定 ] 對話方塊包含下列窗格:

  • 全域事件

    選取 [ FocusChangedEvent ] 核取方塊,以顯示全域焦點變更事件的相關資訊。

  • 事件種類

    選取您感興趣的事件。

  • 範圍

    選取您想要 AccEvent 接聽事件的 UI 元素。

  • 包含來自 的事件

    如果您從 [範圍 ] 窗格中選取 之 UI 元素的即時子項目看到事件,請 選取 [立即子 系]。 如果您想要查看所有子代元素的事件,請選取 [所有子代 ]。

  • 報表屬性

    選取要在主視窗中每個事件之後顯示的屬性。 如果在 [模式 ] 功能表中選取 [顯示資訊工具提示 ],則選取的屬性也會顯示在工具提示中。

篩選作用中協助工具事件

若要設定 [AccEvent] 視窗中顯示的 Microsoft Active Accessibility 事件和屬性,請按一下 [模式 ] 功能表,選取 [WinEvents] 或 [內容中] [WinEvents (內容中] ,然後選取 [設定 ]。 [ WinEvent 設定 ] 對話方塊隨即顯示。 您也可以使用此對話方塊來篩選事件。

[ WinEvent 設定 ] 對話方塊包含下列窗格:

  • 物件

    選取您想要 AccEvent 接聽事件的物件。 AccEvent 可以接聽源自視窗、游標或插入號的事件。 預設會選取視窗

  • 事件

    選取您感興趣的事件。 預設會顯示所有事件。

  • 事件資訊

    選取主視窗中每個事件名稱之後所要顯示的資訊。

  • 物件屬性

    選取要在主視窗中每個事件之後顯示的屬性。 如果在 [模式 ] 功能表中選取 [顯示資訊工具提示 ],則選取的屬性也會顯示在工具提示中。 預設會選取 [名稱 ]、 [角色 ] 和 [狀態 ]。

  • 篩選

    選取篩選區段中的其中一個選項按鈕,以篩選 hWNDs 欄位中指定 視窗所引發的事件。 預設會選取 [不要篩選] 選項按鈕。

    • 選取 [ 排除] 選項按鈕,只顯示從指定視窗以外的物件引發的事件。
    • 選取 [ 只包含單 選按鈕],並指定一或多個視窗控制碼,只顯示從這些視窗引發的事件。
    • 核取 [ 和 子系] 核取方塊,以包含指定視窗子代所引發的事件。
  • 選項

    選取下列任一選項:

    選取此選項時 AccEvent 會執行此工作
    使用 Invoke 使用 IDispatch::Invoke 來擷取物件屬性,而不是使用 IAccessible 方法。
    永遠取得物件 (即使未選取任何物件屬性) 即使 [物件屬性] 窗格中未選取任何專案,仍會擷取與事件相關聯的物件。
    顯示預設屬性(除了選取的屬性之外) 顯示與事件相關聯之物件的預設屬性,以及 [物件屬性] 窗格中選取的專案。
    顯示隱藏/隱藏視窗的事件資訊 顯示所有物件的 [事件資訊] 窗格中選取的專案,包括隱藏或隱藏視窗中的專案。
    顯示隱藏/隱藏視窗的完整事件資訊 顯示 [事件資訊] 窗格中的選取專案,以及 [物件屬性] 窗格中選取的專案,以及所有物件的選取專案,包括隱藏或隱藏視窗中的專案。
    下一個事件的 DebugBreak 導致產生下一個 WinEvent 的進程發生中斷點例外狀況。 這會發出偵錯工具來處理例外狀況的訊號。

使用事件功能表

使用 [ 事件 ] 功能表來執行下列工作:

選取此選項時 AccEvent 會執行此工作
開始接聽 開始在 [資料] 檢視中顯示事件資訊。
停止接聽 停止在 [資料] 檢視中顯示事件資訊。
清除事件歷程記錄 清除 [資料] 檢視的內容。
選取所有事件 選取 [資料] 檢視中列出的所有事件。
複製選取的事件 將選取的事件複製到剪貼簿。

儲存使用中協助工具事件

若要開始將事件儲存至文字檔,請開啟 [ 檔案 ] 功能表,然後選取 [ 開始記錄至檔案 ]。 AccEvent 會開始將事件寫入指定的檔案,直到您從 [檔案 ] 功能表中選取 [ 停止記錄 ] 為止。 文字檔對於稍後的疑難排解和檢閱事件很有用。