共用方式為


輔助功能工具 - 檢查

重要

檢查是舊版工具。 建議您改為 輔助功能深入解析

檢查 (Inspect.exe) 是 Windows 型工具,可選取任何 UI 元素並檢視其輔助功能數據。 您可以檢視Microsoft UI 自動化屬性和控件模式,以及Microsoft Active Accessibility (MSAA) 屬性。 檢查也可以測試使用者介面自動化樹狀結構中自動化項目的導覽結構,以及作用中輔助功能階層中Microsoft可存取的物件。

要求

若要檢查 UI 自動化,使用者介面自動化必須存在於系統上。 如需詳細資訊,請參閱 Run-Time 需求

檢查會安裝為 Windows 軟體開發工具組 (SDK) 中的其中一個工具,其中包含本節記載的所有輔助功能相關工具。 檢查不會以個別下載的形式散發。

下載 Windows SDK

注意

如需舊版 Windows SDK,請參閱 Windows SDK 和模擬器封存

Inspect.exe 位於 SDK 安裝路徑的 \bin\<版本>\<平臺> 資料夾中。 您通常不需要以系統管理員身分執行它。

[檢查] 視窗

[檢查] 視窗有數個主要部分:

  • 標題列。 顯示 檢查 視窗控點 (HWND)。
  • 功能表欄。 提供檢查功能的存取權。
  • 工具列。 提供檢查功能的存取權。
  • 樹視圖。 將UI元素的階層式結構呈現為樹視圖控件,可用來在元素之間巡覽。
  • 數據檢視。 顯示所選取 UI 元素的所有公開輔助功能屬性。

功能表欄中提供的命令也可在工具列中使用。 下圖顯示檢查在記事本中查詢 編輯 功能表項的 UI 自動化屬性。

顯示 [檢查] 工具使用者介面的螢幕快照。

使用檢查

當您開始檢查時,樹視圖會顯示元素階層中目前選取UI元素的位置,而資料檢視則顯示所選UI元素的屬性資訊。 您可以瀏覽 UI 來檢視 UI 中每個元素的輔助功能資訊。 根據預設,檢查會追蹤鍵盤或滑鼠焦點。 當焦點變更時,數據檢視會更新具有焦點之元素的屬性資訊。

若要在 UI 元素之間巡覽,您可以使用下列任一元素:

  • 滑鼠。
  • 鍵盤。
  • 樹視圖中的樹視圖控件。
  • 導覽 功能表中的瀏覽選項。
  • 工具列中的瀏覽選項。

最後三個選項可讓您流覽 UI 的樹狀結構階層。 此樹狀結構在使用者介面自動化和Microsoft作用中輔助功能模式之間可能稍有不同。

驗證輔助功能屬性資訊

數據檢視會顯示目前選取之UI元素的屬性資訊。 您可以設定 [檢查] 以顯示所有輔助功能屬性或這些屬性子集的相關信息。 您也可以指定其他檢視選項,例如 [檢查] 視窗是否保留在其他使用者介面之上,或 [檢查] 是否會醒目提示選取項目周圍的周框。

設定 [檢查] 以以您想要的方式運作之後,請開始在UI元素之間瀏覽並檢視屬性資訊。 檢查會在設定關閉時儲存組態設定,並使用它們來初始化下一個檢查工作階段。

若要設定屬性設定,請遵循下列步驟:

  1. 從 [選項] 功能表中,選取 [設定],或從工具列選取 [顯示設定] 對話框
  2. 在 [主視窗 顯示] 清單中,選取您想要顯示在 [檢查] [數據] 檢視中的屬性。
  3. 在 [資訊工具提示 顯示] 清單中,選取您想要在工具提示中顯示的屬性。
  4. 若要檢視 UI 元素可能不支援的屬性,請選擇 [顯示不支援的屬性
  5. 選取 [確定] 以儲存變更。

若要設定檢視選項,您可以在 選項 功能表或工具列中選取下列檢視選項。

選取此選項時 檢查 採取此動作
永遠在頂端 出現在畫面上任何其他視窗的頂端。
MSAA 模式 顯示Microsoft Active Accessibility 屬性資訊。
UI 自動化模式 顯示UI自動化屬性資訊。
僅顯示 Windows 檢視 僅適用於 MSAA 模式。
原始檢視 呈現樹檢視中UI自動化樹狀結構或MSAA樹狀結構的原始檢視
控件檢視 在樹檢視中呈現UI自動化樹狀結構 控件檢視。 僅適用於使用者介面自動化模式。
內容檢視 在樹檢視中呈現UI自動化樹狀結構 內容檢視。 僅適用於使用者介面自動化模式
使用中暫留工具列 在滑鼠暫留上啟動工具列按鈕,而不是需要按鼠。
發生錯誤時發生嗶聲 在UI自動化或MSAA作業期間偵測到錯誤時發出嗶聲。
SPI_SCREENREADER 旗標 假設螢幕助讀程式存在。 這個選項表示應用程式應該以文字方式提供資訊,而不是以圖形方式提供資訊。 您不應該假設此旗標只是因為螢幕助讀程式存在而設定。
顯示醒目提示矩形 以焦點反白顯示元素周圍的矩形。
顯示插入號醒目提示 醒目提示插入號。 僅適用於 MSAA 模式。
顯示資訊工具提示 在工具提示中顯示屬性資訊。
監看焦點 遵循鍵盤焦點。 選取時,會安裝異步焦點事件攔截,並將插入號移至具有焦點的專案左上方。 此動作會導致檢查在大約一秒內重新整理其屬性。
監看插入號 遵循插入號。 僅適用於 MSAA 模式。
監看游標 遵循游標。
監看工具提示 遵循工具提示。
顯示樹狀結構 顯示樹檢視。

驗證輔助功能流覽

使用 [檢查] 選取 UI 元素后,您可以驗證元素是否公開輔助技術產品的正確 Windows 自動化流覽。

若要確認輔助功能流覽,請遵循下列步驟:

  1. 開啟 [檢查] 和您想要測試的應用程式。

  2. 選取您要從中開始流覽的UI元素。

  3. 在數據檢視中,確認元素公開正確的導覽相關屬性。

  4. 使用樹檢視、流覽 功能表,或工具列上的瀏覽按鈕來巡覽UI,並確認每個元素都公開正確的導覽相關屬性。

    注意

    導覽 功能表選項和導覽工具列按鈕會根據所選元素在樹狀結構中的位置而變更。

與UI元素互動

Windows 自動化會公開方法,讓輔助技術產品與 UI 元素互動,就像使用滑鼠或鍵盤一樣,例如按下按鈕。 [檢查 動作] 功能表可讓測試人員在元素上叫用 Windows Automation 方法,例如使用 Invoke.Invoke 呼叫 IUIAutomationInvokePattern::Invoke 方法。

若要與UI元素互動,請遵循下列步驟:

  1. 開啟 [檢查] 和您想要測試的應用程式。
  2. 選取您要與其互動的UI元素。
  3. 從 [動作] 功能表或工具列中,選取對應至您要叫用之 Windows 自動化方法的動作。

[動作] 功能表包含 [重新整理焦點 專案,以及其他視您選取 UI 自動化模式或 MSAA 模式而有所不同的專案。 在UI自動化模式中,其他專案會反映目前選取的UI元素所支援的控件模式。 在 MSAA 模式中,其他專案一律包含下列動作:

行動 描述
刷新 重新整理使用者介面。 可在 MSAA 和 UI 自動化模式中使用。
默認動作 執行項目的預設動作。
重點 設定專案上的焦點。 可在 MSAA 和 UI 自動化模式中使用。
選擇 選取專案。
擴充選取範圍 延伸項目的選取範圍,以包含第一個選取專案與目前專案之間的所有專案。
新增至選取範圍 選取目前的專案,例如清單專案。
從選取範圍移除 從選取範圍中移除目前的專案。
SetAccValue 將專案的 Microsoft Active Accessibility 值設定為指定的字串。
焦點子系 巡覽至目前具有焦點之專案的子系。
Cursor 的 HitTest 巡覽至滑鼠游標所指定項目的子系。
HitTest... 開啟 [HitTest] 對話框。

鍵盤快捷方式

即使 [檢查] 不是使用中應用程式,也可以使用鍵盤快捷方式叫用許多功能表項。 快速鍵可能會與某些應用程式衝突。

下列鍵盤快速鍵會啟用功能表上的各種選項:

若要執行此選項 使用此鍵盤快捷方式
在游標下叫用對象的預設動作 ([執行預設動作]]。 僅適用於 MSAA 模式。 Ctrl+Shift+F2
選取游標底下的物件(選取]。 僅適用於 MSAA 模式。 Ctrl+Shift+F3
將鍵盤焦點設定為游標下的物件(Focus)。 Ctrl+Shift+F4
從游標底下的物件移至上一個同層級物件。 此命令只會在容器內巡覽至物件(上一個同層級)。 Ctrl+Shift+F5
移至物件的父代 (Parent)。 Ctrl+Shift+F6
移至目前物件的第一個子系(第一個子系)。 Ctrl+Shift+F7
從游標下的物件移至下一個同層級物件。 此命令只會在容器內巡覽至物件(Next Sibling)。 Ctrl+Shift+F8
移至目前對象的最後一個子系 (Last Child)。 Ctrl+Shift+F9
移至滑鼠游標下的物件 (Cursor的 HitTest )。 僅適用於 MSAA 模式。 Ctrl+Shift+1
將 [數據] 檢視的內容複製到剪貼簿([全部複製]。 Ctrl+Shift+4
重新整理數據檢視的內容(重新整理)。 Ctrl+Shift+5
觀看具有焦點的物件(Watch Focus)。 Ctrl+Shift+6
移至游標位於游標上方的同層級物件(Left)。 僅適用於 MSAA 模式。 Ctrl+Shift+7
移至游標位於物件上方的同層級物件(Up)。 僅適用於 MSAA 模式。 Ctrl+Shift+8
移至游標位於游標上方的同層級物件下方(Down)。 僅適用於 MSAA 模式。 Ctrl+Shift+9
移至游標位於游標上方的同層級物件(Right)。 僅適用於 MSAA 模式。 Ctrl+Shift+0

另請參閱