iGridProvider::GetItem 方法 (uiautomationcore.h)
检索指定单元格的 Microsoft UI 自动化提供程序。
语法
HRESULT GetItem(
[in] int row,
[in] int column,
[out, retval] IRawElementProviderSimple **pRetVal
);
参数
[in] row
类型: int
相关行的序号。
[in] column
类型: int
相关列的序号。
[out, retval] pRetVal
类型: IRawElementProviderSimple**
如果单元格为空,则接收指向指定单元格的 UI 自动化提供程序的指针或 null 引用 (Microsoft Visual Basic .NET) Nothing。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
网格坐标从零开始,左上角 (或右上角单元格,具体取决于坐标 (0,0) 的区域设置) 。
如果单元格为空,则仍必须返回 UI 自动化提供程序,以便支持该单元格的 ContainingGrid 属性。 当网格中子元素的布局类似于不规则数组时,这是可能的。
隐藏的行和列(具体取决于提供程序实现)可能会加载到 UI 自动化树中,因此将反映在 IGridProvider::RowCount 和 IGridProvider::ColumnCount 属性中。 如果尚未加载隐藏的行和列,则不应将其计数。
要求
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | uiautomationcore.h (包括 UIAutomation.h) |
DLL | Uiautomationcore.dll |