Función UiaFind (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.
 
Recupera uno o varios nodos de Automatización de la interfaz de usuario que coinciden con los criterios de búsqueda.

Sintaxis

HRESULT UiaFind(
  [in]  HUIANODE        hnode,
  [in]  UiaFindParams   *pParams,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] SAFEARRAY       **ppOffsets,
  [out] SAFEARRAY       **ppTreeStructures
);

Parámetros

[in] hnode

Tipo: HUIANODE

Nodo que se va a usar como punto de partida de la búsqueda.

[in] pParams

Tipo: UiaFindParams*

Dirección de una estructura UiaFindParams que contiene los parámetros de búsqueda.

[in] pRequest

Tipo: UiaCacheRequest*

Dirección de una estructura UiaCacheRequest que especifica qué información 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] ppOffsets

Tipo: SAFEARRAY**

Dirección de una variable que recibe un puntero a un SAFEARRAY que contiene los índices a la matriz de datos solicitada para donde se inicia el subárbol del elemento. Este parámetro se pasa sin inicializar.

[out] ppTreeStructures

Tipo: SAFEARRAY**

Dirección de una variable que recibe un puntero a un SAFEARRAY que contiene 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