Méthode IAccessible ::get_accValue (oleacc.h)

  • Article

La méthode IAccessible ::get_accValue récupère la valeur de l’objet spécifié. Les objets n'ont pas tous une valeur.

Syntaxe

HRESULT get_accValue(
  [in]          VARIANT varChild,
  [out, retval] BSTR    *pszValue
);

Paramètres

[in] varChild

Type : VARIANT

Spécifie si les informations de valeur récupérées appartiennent à l’objet ou à l’un des éléments enfants de l’objet. Ce paramètre est CHILDID_SELF (pour obtenir des informations sur l’objet) ou un ID enfant (pour obtenir des informations sur l’élément enfant de l’objet). Pour plus d’informations sur l’initialisation de la structure VARIANT, consultez Utilisation des ID enfants dans les paramètres.

[out, retval] pszValue

Type : BSTR*

Adresse du BSTR qui reçoit une chaîne localisée qui contient la valeur actuelle de l’objet.

Valeur retournée

Type : HRESULT

En cas de réussite, retourne S_OK.

En cas d’erreur, retourne l’une des valeurs de la table qui suit ou un autre code d’erreur COM standard. Les serveurs retournent ces valeurs, mais les clients doivent toujours case activée paramètres de sortie pour s’assurer qu’ils contiennent des valeurs valides. Pour plus d’informations, consultez Vérification des valeurs de retour IAccessible.

Erreur Description
DISP_E_MEMBERNOTFOUND
 L’objet ne prend pas en charge cette propriété.
E_INVALIDARG
 Un argument n’est pas valide.

Remarques

Les valeurs numériques retournées par les objets accessibles à la barre de défilement et à la barre de suivi indiquent des pourcentages. Il s’agit d’entiers compris entre zéro (0) et cent (100), inclus, mais peuvent également être une plage limitée, par exemple, entre un (1) et seize (16). En outre, certains objets de barre de défilement et de barre de suivi retournent des chaînes qui correspondent à des paramètres tels que la taille de l’écran ou la sécurité Internet.

Remarque pour les développeurs de serveurs : Localisez la chaîne retournée à partir de cette propriété.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête oleacc.h
Bibliothèque Oleacc.lib
DLL Oleacc.dll
Composant redistribuable Active Accessibility 1.3 RDK sur Windows NT 4.0 avec SP6 et versions ultérieures et Windows 95

Voir aussi

Iaccessible

Value, propriété