更新：2007 年 11 月
本主题介绍 UI 自动化对 RadioButton 控件类型的支持。在 UI 自动化中，控件类型是一组条件，控件必须满足这些条件才能使用 ControlTypeProperty 属性。这些条件包括 UI 自动化树结构的特定准则、UI 自动化属性值和控件模式。
单选按钮由圆形按钮和应用程序定义的文本（标签）、图标或指明用户可通过选中按钮所做选择的位图组成。应用程序通常在组框中使用单选按钮，以允许用户从一组相关但互斥的选项中进行选择。例如，应用程序可能会呈现一组单选按钮，用户可以为客户端区域中的选定文本从中选择格式首选项。用户可通过选择对应的单选按钮来选择左对齐、右对齐或置中格式。通常，用户一次只能从一组单选按钮中选择一个选项。
下面各节定义了 RadioButton 控件类型必需的 UI 自动化树结构、属性、控件模式和事件。UI 自动化的要求适用于所有列表控件，无论控件是 Windows Presentation Foundation (WPF)、Win32 还是 Windows 窗体。
本主题包括下列各节。
- 必需的 UI 自动化树结构
- 必需的 UI 自动化属性
- 必需的 UI 自动化控件模式
- 必需的 UI 自动化事件
- 相关主题
必需的 UI 自动化树结构
下表描述了与单选按钮控件有关的 UI 自动化树的控件视图和内容视图，以及每个视图中可包含的内容。有关 UI 自动化树的更多信息，请参见 UI 自动化树概述。
控件视图 |
内容视图 |
|---|---|
|
|
控件视图或内容视图中没有任何子项。
必需的 UI 自动化属性
下表列出了其值或定义与 RadioButton 控件类型特定相关的 UI 自动化属性。有关 UI 自动化属性的更多信息，请参见客户端的 UI 自动化属性。
UI 自动化属性 |
值 |
说明 |
|---|---|---|
AutomationIdProperty() |
请参见“说明”。 |
此属性的值必须在应用程序中的所有控件中保持唯一。 |
请参见“说明”。 |
包含整个控件的最外面的矩形。 |
|
请参见“说明”。 |
如果该控件可以接收键盘焦点，则它必须支持此属性。 |
|
请参见“说明”。 |
单选按钮控件的名称是显示在保持选择状态的按钮旁边的文本。 |
|
请参见“说明”。 |
单选按钮控件的可单击点必须是一个在用鼠标指针单击时在单选按钮上设置选择的点。 |
|
Null |
单选按钮是自标注控件。 |
|
RadioButton |
此值对于所有 UI 框架均相同。 |
|
“单选按钮” |
与 RadioButton 控件类型相对应的本地化字符串。 |
|
True |
单选按钮控件始终包括在 UI 自动化树的内容视图中。 |
|
True |
单选按钮控件始终包括在 UI 自动化树的控件视图中。 |
必需的 UI 自动化控件模式
下表列出了必须由所有单选按钮控件支持的 UI 自动化控件模式。有关控件模式的更多信息，请参见 UI 自动化控件模式概述。
控件模式/控件模式属性 |
支持/值 |
说明 |
|---|---|---|
是 |
所有单选按钮控件都必须支持 Selection Item 模式以使自己能够被选中。 |
|
请参见“说明”。 |
必须始终完成 SelectionContainerProperty，以使 UI 自动化客户端能够确定特定上下文内的哪些其他单选按钮相互关联。 对于单选按钮的 Win32 版本，将不支持此属性，因为无法从旧有框架中获取此信息。 |
|
从不 |
单选按钮在设置之后将无法循环切换其状态。 单选按钮上绝不能支持此模式。 |
必需的 UI 自动化事件
下表列出了必须由所有单选按钮控件支持的 UI 自动化事件。有关事件的更多信息，请参见 UI 自动化事件概述。
UI 自动化事件 |
支持 |
说明 |
|---|---|---|
必需 |
无 |
|
必需 |
无 |
|
ToggleStateProperty property-changed 事件。 |
从不 |
无 |
BoundingRectangleProperty property-changed 事件。 |
必需 |
无 |
IsOffscreenProperty property-changed 事件。 |
必需 |
无 |
IsEnabledProperty property-changed 事件。 |
必需 |
无 |
必需 |
无 |
|
必需 |
无 |