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::RowCountIGridProvider::ColumnCount 属性中。 如果尚未加载隐藏的行和列,则不应将其计数。

要求

   
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 uiautomationcore.h (包括 UIAutomation.h)
DLL Uiautomationcore.dll

另请参阅

IGridProvider

UI 自动化提供程序概述