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
Référence