共用方式為


CheckBox 控制件類型的UI自動化支援

備註

本檔適用於想要使用 System.Windows.Automation 命名空間中定義的受控UI自動化類別的 .NET Framework 開發人員。 如需 UI 自動化的最新資訊,請參閱 Windows 自動化 API:使用者介面自動化

本主題提供 CheckBox 控制件類型的Microsoft使用者介面自動化支援的相關信息。 在UI自動化中,控件類型是控制項必須符合的一組條件,才能使用 ControlTypeProperty 屬性。 這些條件包括UI自動化樹狀結構、UI自動化屬性值和控件模式的特定指導方針。

複選框是物件,用來指出使用者可以與其互動以循環瀏覽該狀態的狀態。 複選框會向用戶顯示二進位檔 (是/否)、(開啟/關閉)或第三個 [開啟]、[關閉]、[不確定] 選項。

下列各節會定義 CheckBox 控制項類型所需的 UI 自動化樹狀結構、屬性、控制件模式和事件。 使用者介面自動化需求適用於所有複選框控件,無論是 Windows Presentation Foundation (WPF)、Win32 或 Windows Forms。

必要的 UI 自動化樹狀結構

下表描述與複選框控件相關的UI自動化樹狀結構的控件檢視和內容檢視,並描述每個檢視中可包含的內容。 如需UI自動化樹狀結構的詳細資訊,請參閱 UI自動化樹狀結構概觀

控制項檢視 內容檢視
勾選框 勾選框

備註

複選框在控件或內容檢視中永遠不會有子元素。 如果控件確實需要包含子專案,這表示應該使用另一個控件類型。

必要的UI自動化屬性

下表列出UI自動化屬性,其值或定義與複選框控件特別相關。 如需UI自動化屬性的詳細資訊,請參閱 用戶端的UI自動化屬性

UI 自動化屬性 價值觀 註釋
AutomationIdProperty 請參閱備註。 這個屬性的值在應用程式中的所有控件中必須是唯一的。
BoundingRectangleProperty 請參閱備註。 包含整個控制項的最外層矩形。
ClickablePointProperty 請參閱備註。 如果有周框,則支援 。 如果周框內的每個點都無法點選,而且您執行特製化的點擊測試,則覆寫並提供可點選的點。
ControlTypeProperty 勾選框 此值與所有使用者介面架構的值相同。
IsContentElementProperty 此屬性的值一律為 True。 這表示複選框控件必須一律包含在UI自動化樹狀結構的內容檢視中。
IsControlElementProperty 此屬性的值一律為 True。 這表示複選框控件必須一律包含在UI自動化樹狀結構的控件檢視中。
IsKeyboardFocusableProperty 請參閱備註。 如果控制項可接收鍵盤焦點,就必定支援此屬性。
LabeledByProperty Null 複選框是自我標記控件。
LocalizedControlTypeProperty “複選框” 對應至 CheckBox 控制件類型的當地語系化字串。
NameProperty 請參閱備註。 複選框控件 Name 的 屬性值是維護切換狀態之方塊旁顯示的文字。

必要的使用者介面自動化控制模式

下表列出所有複選框控件必須支援的UI自動化控制件模式。 如需控制樣式的詳細資訊,請參閱 UI 自動化控制樣式概觀

控制件模式 支援 註釋
IToggleProvider 為必填項目 允許以程式設計方式迴圈查看其內部狀態的複選框。

必要的UI自動化事件

下表列出所有複選框控件必須支援的UI自動化事件。 如需事件的詳細資訊,請參閱 UI 自動化事件概觀

UI 自動化事件 支援 註釋
AutomationFocusChangedEvent 為必填項目 沒有
BoundingRectangleProperty 屬性變更事件。 為必填項目 沒有
IsOffscreenProperty 屬性變更事件。 為必填項目 沒有
IsEnabledProperty 屬性變更事件。 為必填項目 沒有
StructureChangedEvent 為必填項目 沒有
ToggleStateProperty 屬性變更事件。 為必填項目 沒有

默認動作

複選框的默認動作是讓單選按鈕變成焦點,並切換其目前狀態。 如先前所述,複選框是向使用者提出是/否(開/關)決定或三種選項(開啟、關閉、不確定)。 如果複選框是二進位,則默認動作會導致 「on」 狀態變成 「off」 或 「off」 狀態變成 「on」。 在處於三態狀態的複選框中,默認動作會按使用者連續點擊控制項的順序循序切換複選框的狀態。

另請參閱