Compartir a través de

Función UiaNodeFromFocus (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 el nodo Automatización de la interfaz de usuario del elemento de interfaz de usuario que actualmente tiene el foco de entrada.

Sintaxis

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

Parámetros

[in] pRequest

Tipo: UiaCacheRequest*

Dirección de una estructura UiaCacheRequest que contiene información sobre los datos que se van a almacenar en caché.

[out] ppRequestedData

Tipo: SAFEARRAY**

Dirección de una variable que recibe un puntero a un SAFEARRAY que contiene la información solicitada. Este parámetro se pasa sin inicializar.

[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