ItemContainer 控件模式
介绍实现 IItemContainerProvider的准则和约定，包括有关方法的信息。 ItemContainer 控件模式用于支持项虚拟化。
包含大量子项的控件可以使用虚拟化有效地管理项。 借助虚拟化，控件在任何给定时间仅保留一部分项的内存中的完整信息。 通常，该子集仅包含当前对用户可见的那些项。 有关剩余虚拟化项的完整信息保存在存储中，并加载到内存中，或实现，因为控件需要它，例如，随着新项对用户可见。
例如，下图显示了包含数千个虚拟化项的列表框。 由于该控件仅保留当前可见的子项的完整信息，因此提供程序只能为项 100 - 127 公开Microsoft UI 自动化元素。
使用虚拟化的控件是一项挑战，因为仅实现的（去虚拟化）项作为 UI 自动化树中的 UI 自动化元素完全可用。 虚拟化项不存在于树中，因此有关这些项的信息不可用。
为了提供有关虚拟化项的信息，提供程序实现 ItemContainer 控件模式，该模式公开 IItemContainerProvider 接口。 FindItemByProperty 方法根据特定属性的值（例如 Name、AutomationId或 IsSelected）查找子项。 如果虚拟化项，FindItemByProperty 检索项目的 UI 自动化占位符元素。 占位符元素是 IRawElementProviderSimple 接口的实现，该接口仅支持 VirtualizedItem 控件模式。
IVirtualizedItemProvider：：Realize 方法使客户端能够请求实现虚拟化项，从而公开项的完整 UI 自动化元素，以便所有必需的属性和模式都可用。
尽管 ItemContainer 控制模式的主要用途是支持虚拟化容器方案，但无论容器是否使用虚拟化，都可以由任何按名称检索子项的容器实现。
本主题包含以下部分。
实施准则和约定
实现 ItemContainer 控件模式时，请注意以下准则和约定：
- 任何可以包含虚拟化项的控件都必须支持 ItemContainer 控件模式。 支持基于属性值检索项的任何容器都可以支持此模式，而不管容器是否使用虚拟化。
- 虚拟化容器时，其他控件模式（例如 选择、表和 网格）可能会受到影响。 例如，ISelectionProvider：：GetSelection 方法可能仅支持视区中的元素，或仅支持当前未虚拟化的选定元素。
- Scroll 控件模式应不受虚拟化影响。
- 虚拟化项没有项计数或索引信息。 虚拟化控件可以使用 DescribedBy 或 ItemStatus 属性来提供此信息（如有必要）。
- 控件开发人员应记录和发布受虚拟化使用影响的所有 UI 自动化属性和控件模式的详细信息。 尽管 ItemContainer 和 VirtualizedItem 控制模式提供基本支持，但它们可能不支持某些虚拟化行为。
以下准则和要求适用于 IItemContainerProvider：：FindItemByProperty 方法。
- 虽然不需要，Microsoft 但强烈建议 FindItemByProperty 支持 Name、AutomationId和 IsSelected 属性。
- 如果需要遍历多个对象来查找匹配对象，FindItemByProperty 速度可能很慢。
- FindItemByProperty 可以重复调用以按顺序查找项。 只要每个项只返回一次，这些项就可以按任意顺序排列。
- FindItemByProperty 可以实现，以便仅查找显示在 UI 自动化树的控件或内容视图中的元素。 可以跳过仅出现在原始视图中的元素，以避免检索仅代表用户“项”部分的多个元素。
- 当搜索条件与虚拟化项匹配时，提供程序可以返回支持 VirtualizedItem 控件模式的占位符元素。 以下准则适用于占位符元素：
- 检索虚拟化项的占位符元素不能导致 UI 更改。
- 占位符元素必须是其他子元素的对等方（需要结构更改的事件）。
- 如果可能，提供程序可以创建完整的自动化元素，而不是占位符。
- 当搜索条件与非虚拟化元素匹配时，提供程序必须返回实际元素，而不是占位符。
- 找不到项时，IItemContainerProvider：：FindItemByProperty 应将 pFound 参数设置为 NULL 并返回 S_OK。
- 当 propertyId 参数为 0 时，提供程序应在 pStartAfter后返回下一项。
- 如果 pStartAfter 参数 NULL，并且 propertyId 为 0，则提供程序应返回容器中的第一项。
- 当 propertyId 参数为 0 时，将忽略值参数。
以下准则和要求适用于 UI 自动化树中虚拟化项的占位符元素。
- 尽管鼓励提供程序支持占位符元素的更多属性和控件模式，但只需要 VirtualizedItem 控件模式。
- 当 再次调用 IItemContainerProvider：：FindItemByProperty 时，提供程序可能会使以前的占位符元素失效。 （如果客户端需要立即实现占位符元素，则它应立即执行此作;否则，如果 再次调用 findItemByProperty 或视区因任何原因而更改，则元素可能会失效。
- UI作（如滚动或调整大小）可能会导致容器的视区发生更改，并且一组新的子项变为可见。 在这种情况下，以前检索的占位符元素在 UI 自动化树中可能不可用。
- 提供程序不应虚拟化容器对象的视区中屏幕上可用的 UI 元素。
IItemContainerProvider 的必需成员
实现 IItemContainerProvider 接口需要以下方法。
| 必需成员 | 成员类型 | 笔记 |
|---|---|---|
| FindItemByProperty | 方法 | 没有 |
ItemContainer 控件模式没有关联的属性或事件。
相关主题