IUIAutomationElement::GetCurrentPattern, méthode (uiautomationclient.h)

Récupère l’interface IUnknown du modèle de contrôle spécifié sur cet élément UI Automation.

Syntaxe

HRESULT GetCurrentPattern(
  [in]          PATTERNID patternId,
  [out, retval] IUnknown  **patternObject
);

Paramètres

[in] patternId

Type : PATTERNID

Identificateur du modèle de contrôle. Pour obtenir la liste des ID de modèle de contrôle, consultez Identificateurs de modèle de contrôle.

[out, retval] patternObject

Type : IUnknown**

Reçoit un pointeur vers une interface IUnknown .

Valeur retournée

Type : HRESULT

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

Remarques

Cette méthode obtient le modèle de contrôle spécifié en fonction de sa disponibilité au moment de l’appel.

Pour certaines formes d’interface utilisateur, cette méthode entraîne une surcharge de performances inter-processus. Les applications peuvent réduire la surcharge en mettant en cache les modèles de contrôle, puis en les récupérant à l’aide de IUIAutomationElement::GetCachedPattern.

Configuration requise

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

Voir aussi

Conceptuel

GetCachedPattern

GetCurrentPatternAs

IUIAutomationElement

Référence

Vue d'ensemble des modèles de contrôle UI Automation