IAccessible::get_accValue-Methode (oleacc.h)
Die IAccessible::get_accValue-Methode ruft den Wert des angegebenen Objekts ab. Nicht für alle Objekte liegt ein Wert vor.
Syntax
HRESULT get_accValue(
[in] VARIANT varChild,
[out, retval] BSTR *pszValue
);
Parameter
[in] varChild
Typ: VARIANT
Gibt an, ob die abgerufenen Wertinformationen zum -Objekt oder zu einem der untergeordneten Elemente des Objekts gehören. Dieser Parameter ist entweder CHILDID_SELF (zum Abrufen von Informationen über das Objekt) oder eine untergeordnete ID (zum Abrufen von Informationen über das untergeordnete Element des Objekts). Weitere Informationen zum Initialisieren der VARIANT-Struktur finden Sie unter Verwenden untergeordneter IDs in Parametern.
[out, retval] pszValue
Typ: BSTR*
Adresse des BSTR , der eine lokalisierte Zeichenfolge empfängt, die den aktuellen Wert des Objekts enthält.
Rückgabewert
Typ: HRESULT
Gibt bei Erfolg S_OK zurück.
Wenn dies nicht erfolgreich ist, gibt einen der Werte in der folgenden Tabelle oder einen anderen COM-Standardfehlercode zurück. Server geben diese Werte zurück, aber Clients müssen die Ausgabeparameter immer überprüfen, um sicherzustellen, dass sie gültige Werte enthalten. Weitere Informationen finden Sie unter Überprüfen von IAccessible-Rückgabewerten.
| Fehler | BESCHREIBUNG |
|---|---|
|
Das -Objekt unterstützt diese Eigenschaft nicht. |
|
Ein Argument ist ungültig. |
Hinweise
Numerische Werte, die von Scrollleisten- und trackbar-barrierefreien Objekten zurückgegeben werden, geben Prozentsätze an. Sie sind ganze Zahlen zwischen null (0) und hundert (100), einschließlich, können aber auch ein begrenzter Bereich sein, z. B. zwischen 1 (1) und sechzehn (16). Außerdem geben einige Bildlaufleisten- und Trackleistenobjekte Zeichenfolgen zurück, die Einstellungen wie Bildschirmgröße oder Internetsicherheit entsprechen.
Hinweis für Serverentwickler: Lokalisieren Sie die von dieser Eigenschaft zurückgegebene Zeichenfolge.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | oleacc.h |
| Bibliothek | Oleacc.lib |
| DLL | Oleacc.dll |
| Verteilbare Komponente | Active Accessibility 1.3 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 95 |