实现 UI 自动化 SelectionItem 控件模式
备注
本文档适用于想要使用 System.Windows.Automation 命名空间中定义的托管 UI 自动化类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息，请参阅 Windows 自动化 API：UI 自动化。
本主题介绍实现 ISelectionItemProvider的准则和约定，包括有关属性、方法和事件的信息。 本概述的结尾列出了指向其他参考资料的链接。
SelectionItemPattern 控件模式用于支持充当实现 ISelectionProvider的容器控件的独立可选子项的控件。 有关实现此 SelectionItem 控件模式的控件的示例，请参阅 UI 自动化客户端的控件模式映射
实现准则和约定
在实现 Selection Item 控件模式时，请注意以下准则和约定：
- 管理实现 IRawElementProviderFragmentRoot的子控件的单选控件（如“显示属性” 对话框中的“屏幕分辨率” 滑块）应实现 ISelectionProvider ，且其子级应实现 IRawElementProviderFragment 和 ISelectionItemProvider。
ISelectionItemProvider 必需的成员
以下属性、方法和事件都是实现 ISelectionItemProvider所必需的。
| 必需的成员 | 成员类型 | 说明 |
|---|---|---|
| CanSelectMultiple | 属性 | 无 |
| IsSelectionRequired | 属性 | 无 |
| GetSelection | 方法 | 无 |
| InvalidatedEvent | 事件 | 在容器中的选项发生重大更改并需要发送多于 ElementSelectedEvent 常量所允许的 ElementRemovedFromSelectionEvent 和 InvalidateLimit 事件时引发。 |
- 如果 Select、 AddToSelection或 RemoveFromSelection 的结果是单个的选定的项，则应引发 ElementSelectedEvent ；否则根据需要发送 ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent 。
例外
提供程序必须引发以下异常。
| 例外类型 | 条件 |
|---|---|
| InvalidOperationException | 尝试下列任一操作时： - RemoveFromSelection = IsSelectionRequiredProperty = true 并且已选择元素时。- RemoveFromSelection = IsSelectionRequiredProperty = true 并且仅选择了一个元素时。- AddToSelection = CanSelectMultipleProperty = false 并且已选择另一个元素时。 |