Função UiaNavigate (uiautomationcoreapi.h)

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.

 

Navega na árvore Automação da Interface do Usuário, opcionalmente recuperando informações armazenadas em cache.

Sintaxe

HRESULT UiaNavigate(
  [in]  HUIANODE          hnode,
  [in]  NavigateDirection direction,
  [in]  UiaCondition      *pCondition,
  [in]  UiaCacheRequest   *pRequest,
  [out] SAFEARRAY         **ppRequestedData,
  [out] BSTR              *ppTreeStructure
);

Parâmetros

[in] hnode

Tipo: HUIANODE

O elemento no qual a navegação começa.

[in] direction

Tipo: NavigateDirection

Um valor do tipo enumerado NavigateDirection que indica a direção para navegar do hnode.

[in] pCondition

Tipo: UiaCondition*

O endereço de uma estrutura UiaCondition que especifica a condição para a qual o elemento que está sendo navegado deve corresponder. Use esse parâmetro para ignorar elementos que não são de interesse.

[in] pRequest

Tipo: UiaCacheRequest*

O endereço de uma estrutura UiaCacheRequest que contém uma descrição das informações a serem armazenadas em cache.

[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. Consulte Observações.

[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