Compartir a través de

Función UiaNavigate (uiautomationcoreapi.h)

  • Artículo
Nota Esta función está en desuso. En su lugar, las aplicaciones cliente deben usar las interfaces del Modelo de objetos componentes (COM) de Microsoft Automatización de la interfaz de usuario.
 
Navega en el árbol de Automatización de la interfaz de usuario, recuperando opcionalmente la información almacenada en caché.

Sintaxis

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

Elemento en el que comienza la navegación.

[in] direction

Tipo: NavigateDirection

Valor del tipo enumerado NavigateDirection que indica la dirección que se va a navegar desde hnode.

[in] pCondition

Tipo: UiaCondition*

Dirección de una estructura UiaCondition que especifica la condición a la que debe coincidir el elemento al que se navega. Use este parámetro para omitir los elementos que no son de interés.

[in] pRequest

Tipo: UiaCacheRequest*

Dirección de una estructura UiaCacheRequest que contiene una descripción de la información que se va a almacenar en caché.

[out] ppRequestedData

Tipo: SAFEARRAY**

Dirección de una variable que recibe un puntero a un SAFEARRAY que contiene los datos solicitados. Este parámetro se pasa sin inicializar. Vea la sección Comentarios.

[out] ppTreeStructure

Tipo: BSTR*

Dirección de una variable que recibe la descripción de la estructura de árbol. Este parámetro se pasa sin inicializar. Vea la sección Comentarios.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o si un valor de error de lo contrario.

Comentarios

La estructura de árbol se describe mediante una cadena donde cada carácter es "p" o ")". El primer carácter de la cadena siempre representa el nodo raíz. La cadena es NULL si la función no devuelve ningún elemento.

Una "p" representa un nodo (Automatización de la interfaz de usuario elemento). Cuando una "p" sigue directamente a otra, el segundo nodo es un elemento secundario del primero. Una ")" representa un paso hacia arriba del árbol. Por ejemplo, "pp)p" representa un nodo seguido de dos nodos secundarios que son del mismo nivel entre sí. En "pp))p", el último nodo es un elemento relacionado del primero.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiautomationcoreapi.h
Library Uiautomationcore.lib
Archivo DLL Uiautomationcore.dll