Compartilhar via


Método IGridProvider::GetItem (uiautomationcore.h)

Recupera o provedor de Automação da Interface do Usuário da Microsoft para a célula especificada.

Sintaxe

HRESULT GetItem(
  [in]          int                       row,
  [in]          int                       column,
  [out, retval] IRawElementProviderSimple **pRetVal
);

Parâmetros

[in] row

Tipo: int

O número ordinal da linha de interesse.

[in] column

Tipo: int

O número ordinal da coluna de interesse.

[out, retval] pRetVal

Tipo: IRawElementProviderSimple**

Recebe um ponteiro para um provedor de Automação da Interface do Usuário para a célula especificada ou uma referência nula (Nothing no Microsoft Visual Basic .NET) se a célula estiver vazia.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

As coordenadas de grade são baseadas em zero com a célula superior esquerda (ou superior direita, dependendo da localidade) com coordenadas (0,0).

Se uma célula estiver vazia, um provedor de Automação da Interface do Usuário ainda deverá ser retornado para dar suporte à propriedade ContainingGrid dessa célula. Isso é possível quando o layout dos elementos filho na grade é semelhante a uma matriz irregular.

Linhas e colunas ocultas, dependendo da implementação do provedor, podem ser carregadas na árvore de Automação da Interface do Usuário e, portanto, serão refletidas nas propriedades IGridProvider::RowCount e IGridProvider::ColumnCount . Se as linhas e colunas ocultas ainda não tiverem sido carregadas, elas não deverão ser contadas.

Requisitos

   
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho uiautomationcore.h (include UIAutomation.h)
DLL Uiautomationcore.dll

Confira também

IGridProvider

Visão Geral dos Provedores de Automação de Interface do Usuário