UI 自动化对 RadioButton 控件类型的支持
备注
本文档适用于想要使用 System.Windows.Automation 命名空间中定义的托管 UI 自动化类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息，请参阅 Windows 自动化 API：UI 自动化。
本主题介绍 UI 自动化对于 RadioButton 控件类型的支持信息。 在 UI 自动化中，控件类型是一组条件，控件必须满足这些条件才能使用 ControlTypeProperty 属性。 这些条件包括针对 UI 自动化树结构、UI 自动化属性值和控件模式的特定准则。
单选按钮包含一个圆形按钮和应用程序定义的文本（标签）、一个图标或者一个表示用户可以通过选择按钮进行选择的位图。 应用程序通常使用分组框中的单选按钮，以允许用户从一组相关，但相互排斥的选项中进行选择。 例如，应用程序可能会提供一组单选按钮，用户可以从中选择一个客户端区域中所选文本的格式首选项。 用户可以通过选择相应的单选按钮来选择左对齐、右对齐或居中的格式。 通常情况下，用户一次只可以从一组单选按钮中选择一项。
以下几部分定义 RadioButton 控件类型必需的 UI 自动化树结构、属性、控件模式和事件。 UI 自动化要求适用于所有列表控件，无论 Windows Presentation Foundation (WPF)、Win32 还是 Windows 窗体。
必需的 UI 自动化树结构
下表描述与单选按钮控件有关的 UI 自动化树的控件视图和内容视图，以及每个视图中可包含的内容。 有关 UI 自动化树的详细信息，请参阅 UI 自动化树概述。
| 控件视图 | 内容视图 |
|---|---|
| RadioButton | RadioButton |
控件视图或内容视图中没有子级。
必需的 UI 自动化属性
下表列出了值或定义与 RadioButton 控件类型密切相关的 UI 自动化属性。 有关 UI 自动化属性的详细信息，请参阅客户端的 UI 自动化属性。
| UI 自动化属性 | 值 | 说明 |
|---|---|---|
| AutomationIdProperty | 请参阅注释。 | 此属性的值在应用程序的所有控件中都必须保持唯一。 |
| BoundingRectangleProperty | 请参阅注释。 | 包含整个控件的最外层矩形。 |
| IsKeyboardFocusableProperty | 请参阅注释。 | 如果该控件可以接收键盘焦点，则它必须支持此属性。 |
| NameProperty | 请参阅注释。 | 单选按钮控件的名称是保留选定状态的按钮旁显示的文本。 |
| ClickablePointProperty | 请参阅注释。 | 如果用鼠标指针单击，单选按钮控件的可单击点必须是在单选按钮上设置选择的一个点。 |
| LabeledByProperty | Null |
单选按钮为自行进行标记的控件。 |
| ControlTypeProperty | RadioButton | 此值对于所有 UI 框架均相同。 |
| LocalizedControlTypeProperty | “单选按钮” | 与 RadioButton 控件类型相对应的本地化字符串。 |
| IsContentElementProperty | 正确 | 单选按钮控件始终包括在 UI 自动化树的内容视图中。 |
| IsControlElementProperty | 正确 | 单选按钮控件始终包括在 UI 自动化树的控件视图中。 |
必需的 UI 自动化控件模式
下表列出需要由所有单选按钮控件支持的 UI 自动化控件模式。 有关控件模式的详细信息，请参阅 UI Automation Control Patterns Overview。
| 控件模式/控件模式属性 | 支持/值 | 注释 |
|---|---|---|
| ISelectionItemProvider | 是 | 所有单选按钮控件必须支持选择项模式才能使其被选。 |
| SelectionContainer | 请参阅注释。 | SelectionContainerProperty 必须始终是已完成状态，以便 UI 自动化客户端可以确定特定上下文中还有什么其他的单选按钮关联到另一个按钮。 对于单选按钮的 Win32 版本，不支持此属性，因为无法从旧框架中获取此信息。 |
| IToggleProvider | 从不 | 单选按钮设置完成之后将无法循环切换其状态。 单选按钮决不能支持此模式。 |
必需的 UI 自动化事件
下表列出需要由所有单选按钮控件支持的 UI 自动化事件。 有关事件的详细信息，请参阅 F:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty。
| UI 自动化事件 | 支持 | 说明 |
|---|---|---|
| ElementRemovedFromSelectionEvent | 必须 | 无 |
| ElementSelectedEvent | 必须 | 无 |
| ToggleStateProperty 属性更改事件。 | 从不 | 无 |
| BoundingRectangleProperty 属性更改事件。 | 必需 | 无 |
| IsOffscreenProperty 属性更改事件。 | 必需 | 无 |
| IsEnabledProperty 属性更改事件。 | 必需 | 无 |
| AutomationFocusChangedEvent | 必须 | 无 |
| StructureChangedEvent | 必须 | 无 |