实现 UI 自动化 SelectionItem 控件模式

注意注意

本文档的目标读者是欲使用 System.Windows.Automation 命名空间中定义的托管 UI Automation类的 .NET Framework 开发人员。有关 UI Automation的最新信息,请参见 Windows Automation API: UI Automation(Windows 自动化 API:UI 自动化)。

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

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

本主题包括下列各节。

  • 实现准则和约定
  • IselectionItemProvider 必需的成员
  • 异常
  • 相关主题

实现准则和约定

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

IselectionItemProvider 必需的成员

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

必需的成员

成员类型

注释

CanSelectMultiple

Property

IsSelectionRequired

Property

GetSelection

方法

InvalidatedEvent

Event

在容器中的选择发生显著更改时以及需要发送的 ElementSelectedEventElementRemovedFromSelectionEvent 事件超过 InvalidateLimit 常量所允许的数量时引发。

异常

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

异常类型

Condition

InvalidOperationException

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

请参见

任务

在 UI 自动化提供程序中支持控件模式

在 UI 自动化中使用缓存

Fragment Provider Sample

概念

UI 自动化控件模式概述

客户端的 UI 自动化控件模式

实现 UI 自动化 Selection 控件模式

UI 自动化树概述