iSelectionProvider2 接口 (uiautomationcore.h)

扩展 ISelectionItemProvider 接口以提供有关所选项的信息。

继承

ISelectionProvider2 接口继承自 ISelectionProvider 接口。

方法

ISelectionProvider2 接口包含以下方法。

 
ISelectionProvider2::get_CurrentSelectedItem

获取当前选定的项。
ISelectionProvider2::get_FirstSelectedItem

获取一组选定项中的第一个项。
ISelectionProvider2::get_ItemCount

获取选定项的数目。
ISelectionProvider2::get_LastSelectedItem

获取一组选定项中的最后一项。

注解

此接口由 Microsoft UI 自动化 提供程序实现。

当容器中的选择发生重大更改时,提供程序应引发 类型为 UIA_Selection_InvalidatedEventId 的事件。

从列表或 2D 网格中进行选择时,有一些主要信息片段希望更好地向最终用户阅读。 使用 Excel 作为主要示例,AT 需要 4 条main信息来提供良好的体验:

  • 所选内容中的第一个单元格
  • 所选内容中的最后一个单元格
  • 选择的当前项
  • 总计数
显示选定多个单元格的 Excel 电子表格的图像。所选内容从单元格 F5 的右上方开始,在单元格 D7 的左下角结束。 上图演示了 2D 选择的最终状态:
  • 用户从单元格 F5 开始 (请注意,这是焦点输入保留的位置,因为如果键入 ,则数据将)
  • 用户向下选择单元格 F7 的列
  • 然后,用户选择左到单元格 D7

要求

要求
最低受支持的客户端 Windows 10版本 1709 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2016 [桌面应用 |UWP 应用]
目标平台 Windows
标头 uiautomationcore.h (包括 UIAutomation.h)

另请参阅

ISelectionItemProvider

UI 自动化提供程序概述