Compartilhar via


Método IUIAutomation::ElementFromPoint (uiautomationclient.h)

Recupera o elemento de Automação da Interface do Usuário no ponto especificado na área de trabalho.

Sintaxe

HRESULT ElementFromPoint(
  [in]          POINT                pt,
  [out, retval] IUIAutomationElement **element
);

Parâmetros

[in] pt

Tipo: POINT

As coordenadas da área de trabalho do elemento de Automação da Interface do Usuário.

[out, retval] element

Tipo: IUIAutomationElement**

Recebe um ponteiro para o elemento de Automação da Interface do Usuário.

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

O método IUIAutomation::ElementFromPoint retornará o código de erro UIA_E_ELEMENTNOTAVAILABLE se o elemento sob o ponto já for removido quando o método retornar. Os clientes devem lidar com erros desse método normalmente; por exemplo, tentando a chamada novamente.

Requisitos

   
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationclient.h (include UIAutomation.h)

Confira também

IUIAutomation

IUIAutomation::ElementFromPointBuildCache