实现 UI 自动化切换控制模式

注释

本文档适用于想要使用 System.Windows.Automation 命名空间中定义的托管 UI 自动化类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息,请参阅 Windows 自动化 API:UI 自动化

本主题介绍实现的 IToggleProvider准则和约定,包括有关方法和属性的信息。 主题末尾列出了指向其他引用的链接。

控件 TogglePattern 模式用于支持能够循环遍历一组状态并在设置后维持某种状态的控件。 有关实现此控件模式的控件示例,请参阅 UI 自动化客户端的控件模式映射。

实施准则和约定

实现 Toggle 控件模式时,请注意以下准则和约定:

  • 激活时不保持状态的控件(如按钮、工具栏按钮和超链接)必须改为实现 IInvokeProvider

  • 控件必须按以下顺序进行循环:ToggleStateOnOff,如果支持,则为Indeterminate

  • TogglePattern 不提供 SetState(newState) 方法,因为不按相应的 ToggleState 顺序进行循环即直接设置三态复选框存在问题。

  • RadioButton 控件不实现 IToggleProvider,因为它无法在有效状态之间切换。

IToggleProvider 所需的成员

实现 IToggleProvider时需要以下属性和方法。

必需的成员 成员类型 注释
Toggle 方法 没有
ToggleStateProperty 资产 没有

此控件模式没有关联的事件。

例外

此控件模式没有关联的异常。

另请参阅