可存取性工具 - 檢查
重要
檢查是舊版工具。 建議改用 協助工具深入解析 。
Inspect （ Inspect.exe ） 是以 Windows 為基礎的工具，可選取任何 UI 元素並檢視其協助工具資料。 您可以檢視 Microsoft 消費者介面自動化 屬性和控制項模式，以及 Microsoft Active Accessibility （MSAA） 屬性。 檢查也可以測試消費者介面自動化樹狀結構中自動化專案的導覽結構，以及 Microsoft Active Accessibility 階層中的可存取物件。
需求
若要檢查消費者介面自動化，消費者介面自動化必須存在於系統上。 如需詳細資訊，請參閱 執行時間需求 。
檢查會安裝為 Windows 軟體發展工具組 （SDK） 中的其中一個工具，其中包含本節記載的所有協助工具相關工具。 檢查不會以個別下載的形式散發。
注意
如需舊版 Windows SDK，請參閱 Windows SDK 和模擬器封存 。
Inspect.exe 位於 SDK 安裝路徑的 \bin\ < version > \ < platform > 資料夾中。 您通常不需要以系統管理員身分執行它。
[檢查] 視窗
[ 檢查] 視窗有數個主要部分：
- 標題列。 顯示 [ 檢查 ] 視窗控制碼 （HWND）。
- 功能表列。 提供檢查功能的存取權。
- 工具 欄。 提供檢查功能的存取權。
- 樹狀檢視。 將 UI 元素的階層式結構呈現為樹狀檢視控制項，可用來在元素之間巡覽。
- 資料檢視。 顯示所選 UI 元素的所有公開協助工具屬性。
功能表列中提供的命令也可在工具列中使用。 下圖顯示檢查查詢記事本中 [編輯 ] 功能表項目的消費者介面自動化屬性 。
使用檢查
當您開始檢查時，樹狀檢視會顯示元素階層中目前選取 UI 元素的位置，而資料檢視則顯示所選 UI 元素的屬性資訊。 您可以流覽 UI 來檢視 UI 中每個元素的協助工具資訊。 根據預設，檢查會追蹤鍵盤或滑鼠焦點。 當焦點變更時，資料檢視會更新具有焦點之元素的屬性資訊。
若要在 UI 元素之間巡覽，您可以使用下列任一元素：
- 滑鼠。
- 鍵盤。
- 樹狀檢視中的樹狀檢視控制項。
- 流覽功能表中的 流覽選項。
- 工具列中的流覽選項。
最後三個選項可讓您流覽 UI 的樹狀結構階層。 此樹狀結構在消費者介面自動化與 Microsoft Active Accessibility 模式之間可能稍有不同。
驗證協助工具屬性資訊
資料檢視會顯示目前選取之 UI 元素的屬性資訊。 您可以設定 [檢查] 以顯示所有協助工具屬性或這些屬性子集的相關資訊。 您也可以指定其他檢視選項，例如 [檢查] 視窗是否保留在其他使用者介面之上，或 [檢查] 是否會醒目提示選取專案周圍的周框。
設定 [檢查] 以以您想要的方式運作之後，請開始在 UI 元素之間流覽並檢視屬性資訊。 檢查會在設定關閉時儲存組態設定，並使用它們來初始化下一個檢查會話。
若要設定屬性設定，請遵循下列步驟：
- 從 [ 選項] 功能表中，選取 [設定 ]，或從工具列選取 [ 顯示設定對話方塊 ]。
- 在 [ 主視窗 顯示] 清單中，選取您想要顯示在 [檢查] [資料] 檢視中的屬性。
- 在 [ 資訊工具提示 中顯示] 清單中，選取您想要在工具提示中顯示的屬性。
- 若要檢視 UI 元素可能不支援的屬性，請選取 [顯示不支援的屬性 ]。
- 選取 [確定] 以儲存您的變更。
若要設定檢視選項，您可以在 [選項 ] 功能表或工具列中 選取下列檢視選項。
| 選取此選項時 | 檢查 會採取此動作 |
|---|---|
| 一律在最上芳 | 出現在畫面上任何其他視窗的頂端。 |
| MSAA 模式 | 顯示 Microsoft Active Accessibility 屬性資訊。 |
| 消費者介面自動化模式 | 顯示消費者介面自動化屬性資訊。 |
| 僅顯示 Windows 檢視 | 僅適用于 MSAA 模式。 |
| 未經處理的檢視 | 在樹狀檢視中呈現消費者介面自動化樹狀結構或 MSAA 樹狀結構的原始檢視 。 |
| 控制項檢視 | 呈現 樹狀檢視中消費者介面自動化樹狀結構的控制項檢視 。 僅適用于消費者介面自動化模式。 |
| 內容檢視 | 呈現 樹狀檢視中消費者介面自動化樹狀結構的內容檢視 。 僅適用于消費者介面自動化模式 |
| 使用中暫留工具列 | 在滑鼠暫留上啟動工具列按鈕，而不是需要按一下滑鼠。 |
| 發生錯誤時發生嗶聲 | 在消費者介面自動化或 MSAA 作業期間偵測到錯誤時發出嗶聲。 |
| SPI_SCREENREADER 旗標 | 假設螢幕助讀程式存在。 此選項表示應用程式應該以文字方式提供資訊，而不是以圖形方式提供資訊。 您不應該假設此旗標只是因為螢幕助讀程式存在而設定。 |
| 顯示醒目提示矩形 | 以焦點反白顯示元素周圍的矩形。 |
| 顯示插入號醒目提示 | 醒目提示插入號。 僅適用于 MSAA 模式。 |
| 顯示資訊工具提示 | 在工具提示中顯示內容資訊。 |
| 監看焦點 | 遵循鍵盤焦點。 選取時，會安裝非同步焦點事件攔截，並將插入號移至具有焦點的專案左上方。 此動作會導致檢查在大約一秒內重新整理其屬性。 |
| 監看插入號 | 遵循插入號。 僅適用于 MSAA 模式。 |
| 監看游標 | 遵循游標。 |
| 監看工具提示 | 遵循工具提示。 |
| 顯示樹狀結構 | 顯示樹狀檢視。 |
驗證協助工具流覽
使用 [檢查] 選取 UI 元素後，您可以驗證元素是否公開輔助技術產品的正確 Windows 自動化流覽。
若要確認協助工具流覽，請遵循下列步驟：
開啟 [檢查] 和您想要測試的應用程式。
選取您要從中開始流覽的 UI 元素。
在資料檢視中，確認元素公開正確的導覽相關屬性。
使用樹狀檢視、 導覽 功能表或工具列上的瀏覽按鈕來巡覽 UI，並確認每個元素都公開正確的流覽相關屬性。
注意
導覽 功能表選項和導覽工具列按鈕會根據所選元素在樹狀結構中的位置而變更。
與 UI 元素互動
Windows 自動化會公開方法，讓輔助技術產品與 UI 元素互動，就像使用滑鼠或鍵盤一樣，例如按下按鈕。 [檢查 動作] 功能表可讓測試人員叫用元素上的 Windows 自動化方法，例如使用 Invoke.Invoke 呼叫 IUIAutomationInvokePattern：：Invoke 方法。
若要與 UI 元素互動，請遵循下列步驟：
- 開啟 [檢查] 和您想要測試的應用程式。
- 選取您要與其互動的 UI 元素。
- 從 [ 動作] 功能表或工具列中，選取對應至您要叫用之 Windows 自動化方法的動作。
[動作 ] 功能表包含 [ 重新 整理] 和 [焦點 ] 專案，以及其他視您選取消費者介面自動化模式或 MSAA 模式而有所不同的專案。 在消費者介面自動化模式中，其他專案會反映目前選取的 UI 元素所支援的控制項模式。 在 MSAA 模式中，其他專案一律包含下列動作：
| 動作 | 描述 |
|---|---|
| 重新整理 | 重新整理使用者介面。 可在 MSAA 和 消費者介面自動化 模式中使用。 |
| 預設動作 | 執行 專案的預設動作。 |
| 焦點 | 設定專案上的焦點。 可在 MSAA 和 消費者介面自動化 模式中使用。 |
| 選擇 | 選取 專案。 |
| 擴充選取範圍 | 延伸專案的選取範圍，以包含第一個選取專案與目前專案之間的所有專案。 |
| 新增至選取範圍 | 選取目前的專案，例如清單專案。 |
| 從選取範圍移除 | 從選取範圍中移除目前的專案。 |
| SetAccValue | 將專案的 Microsoft Active Accessibility 值設定為指定的字串。 |
| 焦點子系 | 巡覽至目前具有焦點之專案的子系。 |
| Cursor 的 HitTest | 巡覽至滑鼠游標所指定專案的子系。 |
| HitTest... | 開啟 HitTest 對話方塊。 |
鍵盤快速鍵
即使 [檢查] 不是使用中應用程式，也可以使用鍵盤快速鍵叫用許多功能表項目。 快速鍵可能會與某些應用程式衝突。
下列鍵盤快速鍵會啟用功能表上的各種選項：
| 若要執行此選項 | 請使用這個鍵盤快速鍵 |
|---|---|
| 叫用游標下物件的預設動作（ 執行預設動作 ）。 僅適用于 MSAA 模式。 | Ctrl+Shift+F2 |
| 選取游標底下的物件 （ Select ）。 僅適用于 MSAA 模式。 | Ctrl+Shift+F3 |
| 將鍵盤焦點設定為游標下的物件 （ Focus ）。 | Ctrl+Shift+F4 |
| 從游標底下的物件移至上一個同層級物件。 此命令只會在容器內巡覽至物件（ 上一個同層級 ）。 | Ctrl+Shift+F5 |
| 移至物件的父代 （ Parent ）。 | Ctrl+Shift+F6 |
| 移至目前物件的第一個子系（ 第一個子系 ）。 | Ctrl+Shift+F7 |
| 從游標下的物件移至下一個同層級物件。 此命令只會在容器內巡覽至物件（ 下一個同層級 ）。 | Ctrl+Shift+F8 |
| 移至目前物件的最後一個子系（ 最後一個子系 ）。 | Ctrl+Shift+F9 |
| 移至滑鼠游標下的物件（ Cursor 上的 HitTest）。 僅適用于 MSAA 模式。 | Ctrl+Shift+1 |
| 將 [資料] 檢視的內容複寫到剪貼簿（ 全部 複製）。 | Ctrl+Shift+4 |
| 重新整理資料檢視的內容（ 重新整理 ）。 | Ctrl+Shift+5 |
| 觀看具有焦點的物件（ 監看焦點 ）。 | Ctrl+Shift+6 |
| 移至游標位於游標上方的同層級物件左邊（ Left ）。 僅適用于 MSAA 模式。 | Ctrl+Shift+7 |
| 移至游標位於物件上方的同層級物件（ 向上 ）。 僅適用于 MSAA 模式。 | Ctrl+Shift+8 |
| 移至游標位於游標上方的同層級物件下方（ 向下 ）。 僅適用于 MSAA 模式。 | Ctrl+Shift+9 |
| 移至游標位於游標上方的同層級物件右邊（ 右 ）。 僅適用于 MSAA 模式。 | Ctrl+Shift+0 |
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應