IUIAutomation ::GetFocusedElement, méthode (uiautomationclient.h)

Récupère l’élément UI Automation qui a le focus d’entrée.

Syntaxe

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

Paramètres

[out, retval] element

Type : IUIAutomationElement**

Reçoit un pointeur vers l’élément UI Automation.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La méthode IUIAutomation ::GetFocusedElement retourne le code d’erreur UIA_E_ELEMENTNOTAVAILABLE si l’élément focus est déjà supprimé au moment où la méthode est retournée. Les clients doivent gérer correctement les erreurs de cette méthode ; par exemple, en essayant à nouveau l’appel.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista, Windows XP avec SP3 et Mise à jour de plateforme pour Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008, Windows Server 2003 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)