实现 UI 自动化 SelectionItem 控件模式

更新：2007 年 11 月

本主题介绍实现 ISelectionItemProvider 的准则和约定，其中包括有关属性、方法和事件的信息。本概述的结尾列出了指向其他参考资料的链接。

SelectionItemPattern 控件模式用于支持充当容器控件的各个可选子项的控件，这些容器控件实现 ISelectionProvider。有关实现 SelectionItem 控件模式的控件示例，请参见 UI 自动化客户端的控件模式映射。

本主题包括下列各节。

实现准则和约定

在实现 Selection Item 控件模式时，请注意以下准则和约定：

管理实现 IRawElementProviderFragmentRoot 的子控件的单选控件（如“显示属性”对话框中的“屏幕分辨率”滑块）应实现 ISelectionProvider，并且其子控件应实现 IRawElementProviderFragment 和 ISelectionItemProvider。

实现 ISelectionItemProvider 需要以下属性、方法和事件。

必需的成员	成员类型	说明
CanSelectMultiple	属性	无
IsSelectionRequired	属性	无
GetSelection	方法	无
InvalidatedEvent	事件	在容器中的选择发生显著更改时以及需要发送的 ElementSelectedEvent 和 ElementRemovedFromSelectionEvent 事件超过 InvalidateLimit 常量所允许的数量时引发。

提供程序必须引发以下异常。

异常类型	条件
InvalidOperationException	尝试了以下任何一种方法后：在 IsSelectionRequiredProperty = true 并且已选择了元素的单项选择容器上调用 RemoveFromSelection。在 IsSelectionRequiredProperty = true 并且只选择一个元素的多项选择容器上调用 RemoveFromSelection。在 CanSelectMultipleProperty = false 并且已选择了另一个元素的单项选择容器上调用 AddToSelection。

尝试了以下任何一种方法后：