IAccessible::get_accValue-Methode (oleacc.h)

  • Artikel

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
DISP_E_MEMBERNOTFOUND
 Das -Objekt unterstützt diese Eigenschaft nicht.
E_INVALIDARG
 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

Weitere Informationen

Iaccessible

Value-Eigenschaft