Share via

Função UiaNodeFromPoint (uiautomationcoreapi.h)

  • Artigo
Nota Essa função foi preterida. Em vez disso, os aplicativos cliente devem usar as interfaces COM (Modelo de Objeto de Componente) do Microsoft Automação da Interface do Usuário.
 
Recupera o nó Automação da Interface do Usuário para o elemento no ponto especificado.

Sintaxe

HRESULT UiaNodeFromPoint(
  [in]  double          x,
  [in]  double          y,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

Parâmetros

[in] x

Tipo: duplo

A coordenada horizontal do ponto.

[in] y

Tipo: duplo

A coordenada vertical do ponto.

[in] pRequest

Tipo: UiaCacheRequest*

O endereço de uma estrutura UiaCacheRequest que contém a solicitação de cache para obter informações do cliente.

[out] ppRequestedData

Tipo: SAFEARRAY**

O endereço de uma variável que recebe um ponteiro para um SAFEARRAY que contém os dados solicitados. Este parâmetro é passado não inicializado.

[out] ppTreeStructure

Tipo: BSTR*

O endereço de uma variável que recebe a descrição da estrutura de árvore. Este parâmetro é passado não inicializado. Consulte Observações.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, caso contrário.

Comentários

O elemento retornado será o elemento mais próximo na estrutura de árvore Automação da Interface do Usuário que corresponde aos critérios especificados.

A estrutura de árvore é descrita por uma cadeia de caracteres em que cada caractere é "p" ou ")". O primeiro caractere na cadeia de caracteres sempre representa o nó raiz. A cadeia de caracteres será NULL se nenhum elemento for retornado pela função .

Um "p" representa um nó (elemento Automação da Interface do Usuário). Quando um "p" segue diretamente o outro, o segundo nó é um filho do primeiro. Um ")" representa um passo atrás na árvore. Por exemplo, "pp)p" representa um nó seguido por dois nós filho que são irmãos um do outro. Em "pp))p", o último nó é um irmão do primeiro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationcoreapi.h
Biblioteca Uiautomationcore.lib
DLL Uiautomationcore.dll