实现 UI 自动化 Toggle 控件模式
备注
本文档适用于想要使用 System.Windows.Automation 命名空间中定义的托管 UI 自动化类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息，请参阅 Windows 自动化 API：UI 自动化。
本主题介绍实现 IToggleProvider的准则和约定，包括有关方法和属性的信息。 本主题的结尾列出了指向其他参考资料的链接。
TogglePattern 控件模式用于支持可在一组状态间进行循环，并在设置后保持其状态的控件。 有关实现此控件模式的控件示例，请参阅 Control Pattern Mapping for UI Automation Clients。
实现准则和约定
在实现“切换”控件模式时，请注意以下准则和约定：
不保持激活时的状态的控件（如按钮、工具栏按钮和超链接）则必须实现 IInvokeProvider 。
控件必须按以下顺序在其 ToggleState 间进行循环： On、 Off ，以及 Indeterminate（如果支持）。
TogglePattern 不提供 SetState(newState) 方法，因为不按相应的 ToggleState 顺序进行循环即直接设置三态复选框存在问题。
单选按钮控件不会实现 IToggleProvider，因为它不能在其有效状态间进行循环。
IToggleProvider 必需的成员
实现 IToggleProvider需要以下属性和方法。
| 必需的成员 | 成员类型 | 说明 |
|---|---|---|
| Toggle | 方法 | 无 |
| ToggleStateProperty | 属性 | 无 |
没有与此控件模式关联的事件。
例外
没有与此控件模式关联的异常。