RadioButton 控件類型
本主題提供 RadioButton 控件類型Microsoft使用者介面自動化支援的相關信息。
單選按鈕是由圓形按鈕和應用程式定義的文字（標籤）、圖示或點陣圖所組成，表示使用者可以選取按鈕來進行的選擇。 應用程式通常會使用群組方塊中的單選按鈕，允許使用者從一組相關但互斥的選項中選擇。 例如，應用程式可能會呈現一組單選按鈕，用戶可以從中選取工作區中所選取文字的格式喜好設定。 用戶可以選取對應的單選按鈕，以選取靠左對齊、靠右對齊或置中格式。 一般而言，使用者一次只能從一組單選按鈕中選取一個選項。
注意
按鈕的另一個控件一般化，其中只有一個可以選取群組中的按鈕是切換按鈕的內容。 某些UI架構會將單選按鈕視為特製化的切換按鈕。
下列各節會定義 RadioButton 控件類型所需的 UI 自動化樹狀結構、屬性、控制項模式和事件。 使用者介面自動化需求適用於所有按鈕控制件，其中UI架構/平臺會整合控件類型和控制項模式的UI自動化支援。
本主題包含下列各節。
一般樹狀結構
下表描述與單選按鈕控件相關的UI自動化樹狀結構一般控件和內容檢視，並描述每個檢視中可包含的內容。 如需 UI 自動化樹狀結構的詳細資訊，請參閱 UI 自動化樹狀結構概觀。
| 控件檢視 | 內容檢視 |
|---|---|
|
|
控件檢視或內容檢視中沒有子系。
相關屬性
下表列出UI自動化屬性，其值或定義與實作 RadioButton 控件類型（例如按鈕控件）的控件特別相關。 如需 UI 自動化屬性的詳細資訊，請參閱 從 UI 自動化元素擷取屬性。
| UI 自動化屬性 | 價值 | 筆記 |
|---|---|---|
| UIA_AutomationIdPropertyId | 請參閱附注。 | 在UI自動化樹狀結構的原始檢視中，此屬性的值在所有對等專案之間必須是唯一的。 |
| UIA_BoundingRectanglePropertyId | 請參閱附注。 | 包含整個控件的最外框。 |
| UIA_ClickablePointPropertyId | 請參閱附注。 | 可點選的點必須是按下時選取單選按鈕的點。 |
| UIA_ControlTypePropertyId | RadioButton | |
| UIA_IsContentElementPropertyId | 真 | 單選按鈕控件一律包含在UI自動化樹狀結構的內容檢視中。 |
| UIA_IsControlElementPropertyId | 真 | 單選按鈕控件一律包含在UI自動化樹狀結構的控件檢視中。 |
| UIA_IsKeyboardFocusablePropertyId | 請參閱附注。 | 如果控件可以接收鍵盤焦點，它必須支援這個屬性。 |
| UIA_LabeledByPropertyId | 零 | 單選按鈕控制項會由其內容自我標記。 |
| UIA_LocalizedControlTypePropertyId | 請參閱附注。 | 對應至 RadioButton 控件類型的當地語系化字串。 默認值為 en-US 或英文（美國）的「單選按鈕」。 |
| UIA_NamePropertyId | 請參閱附注。 | 單選按鈕控制件的名稱是維持選取狀態之按鈕旁邊顯示的文字。 |
必要的控制件模式
下表列出所有單選按鈕控制項必須支援的UI自動化控制件模式。 如需控制樣式的詳細資訊，請參閱 UI 自動化控制樣式概觀。
| 控制件模式/模式屬性 | 支援/值 | 筆記 |
|---|---|---|
| ISelectionItemProvider | 必填 | 所有單選按鈕控件都必須支援 SelectionItem 控件模式，才能自行選取。 |
| SelectionContainer | 請參閱附注。 | 必須一律完成 SelectionContainer 屬性，才能讓 UI 自動化客戶端判斷特定內容中其他單選按鈕彼此相關的內容。 對於單選按鈕的 Microsoft Win32 版本，不支援此屬性，因為無法從該舊版架構取得此資訊。 |
| IToggleProvider | 從不 | 一旦設定單選按鈕，單選按鈕就無法迴圈執行其狀態。 單選按鈕上不得支援 切換 控件模式。 |
必要事件
下表列出需要按鈕控制項才能支援的UI自動化事件。 如需事件的詳細資訊，請參閱 UI 自動化事件概觀。
| UI 自動化事件 | 筆記 |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId 屬性變更事件。 | |
| UIA_IsEnabledPropertyId 屬性變更事件。 | 如果控件支援 IsEnabled 屬性，則必須支援這個事件。 |
| UIA_IsOffscreenPropertyId 屬性變更事件。 | 如果控件支援 IsOffscreen 屬性，它就必須支援這個事件。 |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | 如果控件支援 SelectionItem 控件模式，則必須支援這個事件。 |
| UIA_SelectionItem_ElementSelectedEventId | 如果控件支援 SelectionItem 控件模式，則必須支援這個事件。 |
| UIA_StructureChangedEventId |
言論
單選按鈕代表一組對等單選按鈕之間的單一可選取選項。 在理想情況下，單選按鈕應該有群組元素，以釐清對等單選按鈕的界限。 不過，界限通常由UI元素結構所隱含。 例如，功能表可能包含一組連續單選按鈕，而不是功能表項，或一組在群組卷標之後發生的單選按鈕，但在按鈕等可作的元素之前。
相關主題