IAccessible::get_accChildCount

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

HRESULT get_accChildCount(
long* pcountChildren);

Parameters

  • pcountChildren
    [out, retval] 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 Values

If successful, returns S_OK.

If not successful, returns a standard COM error code. Although servers return these values, 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

**  Windows NT/2000/XP/Server 2003:** Included in Windows 2000 and later.
**  Windows 95/98/Me:** Included in Windows 98 and later.
**  Redistributable:** Requires Active Accessibility 1.3 RDK on Windows NT 4.0 SP6 and Windows 95.
**  Header:** Declared in Oleacc.h.
**  Library:** Use Oleacc.lib.

See Also

IAccessible::get_accParent, IAccessible::get_accChild, AccessibleChildren