Méthode IUIAutomationElement ::GetCurrentPropertyValueEx (uiautomationclient.h)

Article
03/06/2024

Récupère une valeur de propriété pour cet élément UI Automation, en ignorant éventuellement toute valeur par défaut.

Syntaxe

HRESULT GetCurrentPropertyValueEx(
  [in]          PROPERTYID propertyId,
  [in]          BOOL       ignoreDefaultValue,
  [out, retval] VARIANT    *retVal
);

Paramètres

[in] propertyId

Type : PROPERTYID

Identificateur de la propriété. Pour obtenir la liste des ID de propriété, consultez Identificateurs de propriétés.

[in] ignoreDefaultValue

Type : BOOL

Valeur qui spécifie si une valeur par défaut doit être ignorée si la propriété spécifiée n’est pas prise en charge : TRUE si la valeur par défaut ne doit pas être retournée, ou FALSE si elle doit être retournée.

[out, retval] retVal

Type : VARIANT*

Reçoit la valeur de la propriété.

Valeur retournée

Type : HRESULT

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

Remarques

Passer FALSE dans le paramètre ignoreDefaultValue équivaut à appeler IUIAutomationElement ::GetCurrentPropertyValue.

Si le fournisseur Microsoft UI Automation pour l’élément lui-même prend en charge la propriété, la valeur de la propriété est retournée. Sinon, si ignoreDefaultValue a la valeur FALSE, une valeur par défaut spécifiée par UI Automation est retournée.

Cette méthode retourne un code d’échec si la propriété demandée n’a pas été mise en cache précédemment.

UI Automation propriétés du type double prennent en charge les valeurs Not a Number (NaN). Lors de la récupération d’une propriété du type double , un client peut utiliser la fonction _isnan pour déterminer si la propriété est une valeur NaN.

Configuration requise

Condition requise	Valeur
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)