Compartilhar via

Função UiaNodeFromFocus (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 de interface do usuário que atualmente tem foco de entrada.

Sintaxe

HRESULT UiaNodeFromFocus(
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

Parâmetros

[in] pRequest

Tipo: UiaCacheRequest*

O endereço de uma estrutura UiaCacheRequest que contém informações sobre dados a serem armazenados em cache.

[out] ppRequestedData

Tipo: SAFEARRAY**

O endereço de uma variável que recebe um ponteiro para um SAFEARRAY que contém as informações solicitadas. 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

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