IAccessible::get_accChildCount-Methode (oleacc.h)

Die IAccessible::get_accChildCount-Methode ruft die Anzahl der untergeordneten Elemente ab, die zu diesem Objekt gehören. Alle -Objekte müssen diese Eigenschaft unterstützen.

Syntax

HRESULT get_accChildCount(
  [out, retval] long *pcountChildren
);

Parameter

[out, retval] pcountChildren

Typ: long*

Adresse einer Variablen, die die Anzahl der untergeordneten Elemente empfängt, die zu diesem Objekt gehören. Die untergeordneten Elemente sind barrierefreie Objekte oder untergeordnete Elemente. Wenn das Objekt keine untergeordneten Elemente aufweist, ist dieser Wert null.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

Wenn dies nicht erfolgreich ist, wird ein COM-Standardfehlercode zurückgegeben. 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.

Hinweise

Die Anzahl der untergeordneten Elemente in einem Objekt kann sich ändern. Eine Anwendung verfolgt die Änderungen an der untergeordneten Anzahl nach, indem sie auf EVENT_OBJECT_CREATE und EVENT_OBJECT_DESTROY Ereignisse überwacht, die von diesem Objekt generiert werden.

Hinweis für Serverentwickler: Wenn das Objekt keine untergeordneten Elemente aufweist, geben Sie S_OK zurück, und legen Sie pcountChildren auf null fest.

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

AccessibleChildren

Iaccessible

IAccessible::get_accChild

IAccessible::get_accParent