Export (0) Print
Expand All

IAccessible::get_accChildCount method

The IAccessible::get_accChildCount method retrieves the number of children that belong to this object. All objects must support this property.

Syntax


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

Parameters

pcountChildren [out, retval]

Type: long*

Address of a variable that receives the number of children that belong to this object. The children are accessible objects or child elements. If the object has no children, this value is zero.

Return value

Type: HRESULT

If successful, returns S_OK.

If not successful, returns a standard COM error code. Servers return these values, but clients must always check output parameters to ensure that they contain valid values. For more information, see Checking IAccessible Return Values.

Remarks

The number of children in an object can change. An application tracks the changes to the child count by watching for EVENT_OBJECT_CREATE and EVENT_OBJECT_DESTROY events generated by this object.

Note to server developers:  If the object does not have any children, return S_OK and set pcountChildren to zero.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Redistributable

Active Accessibility 1.3 RDK on Windows NT 4.0 with SP6 and later and Windows 95

Header

Oleacc.h

Library

Oleacc.lib

DLL

Oleacc.dll

See also

IAccessible
IAccessible::get_accParent
IAccessible::get_accChild
AccessibleChildren

 

 

Community Additions

ADD
Show:
© 2014 Microsoft