实现 UI 自动化 ScrollItem 控件模式

注释

本文档适用于想要使用 System.Windows.Automation 命名空间中定义的托管 UI 自动化类的 .NET Framework 开发人员。 有关 UI 自动化的最新信息,请参阅 Windows 自动化 API:UI 自动化

本主题介绍实现 IScrollItemProvider相关指南和约定,包括有关属性、方法和事件的信息。 主题末尾列出了指向其他引用的链接。

控件 ScrollItemPattern 模式用于支持实现 IScrollProvider的容器的单个子控件。 此控件模式充当子控件与其容器之间的通信通道,以确保容器可以更改其视区内的当前可见内容(或区域)以显示子控件。 有关实现此控件模式的控件示例,请参阅 UI 自动化客户端的控件模式映射。

实施准则和约定

实现滚动项控件模式时,请注意以下准则和约定:

  • 在窗口或画布控件中包含的项不需要实现 IScrollItemProvider 接口。 但是作为替代方法,它们必须公开 BoundingRectangleProperty 的一个有效位置。 这将允许 UI 自动化客户端应用程序使用 ScrollPattern 容器上的控件模式方法显示子项。

IScrollItemProvider 必需的成员

实现 IScrollProvider 接口需要以下方法。

必需成员 成员类型 注释
ScrollIntoView -方法 没有

此控件模式没有关联的属性或事件。

例外

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

异常类型 条件
InvalidOperationException 如果无法将项目滚动到可见范围内:

- ScrollIntoView

另请参阅