Partager via


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

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

Syntaxe

HRESULT GetCachedPropertyValueEx(
  [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

Cette méthode récupère la propriété spécifiée à partir du cache de l’élément UI Automation. Pour récupérer la propriété actuelle, appelez IUIAutomationElement ::GetCurrentPropertyValueEx.

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

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)

Voir aussi

Conceptuel

Getcachedpropertyvalue

GetCurrentPropertyValueEx

IUIAutomationElement

Référence

Vue d'ensemble des propriétés UI Automation