Método IUIAutomation::GetFocusedElement (uiautomationclient.h)

Recupera el elemento Automatización de la interfaz de usuario que tiene el foco de entrada.

Sintaxis

HRESULT GetFocusedElement(
  [out, retval] IUIAutomationElement **element
);

Parámetros

[out, retval] element

Tipo: IUIAutomationElement**

Recibe un puntero al elemento Automatización de la interfaz de usuario.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El método IUIAutomation::GetFocusedElement devuelve el código de error UIA_E_ELEMENTNOTAVAILABLE si el elemento centrado ya se ha quitado en el momento en que devuelve el método. Los clientes deben controlar los errores de este método correctamente; por ejemplo, intentando volver a intentar la llamada.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista, Windows XP con SP3 y Platform Update para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiautomationclient.h (include UIAutomation.h)