GetChildItemCount

Description

Determines the total number of child items in a parent (Category, Panel, or Group) of the RibbonBar control.

Applies to

RibbonBar controls

Syntax

controlname.GetChildItemCount ( Long Handle )

Argument

Description

controlname

The name of the RibbonBar control.

Handle

The handle of the parent object whose child items you want to count. The parent object can be Category, Panel, or Group.


Return value

Integer.

Returns the total number of child items in the parent. If the parent contains no items, returns 0. If an error occurs, returns -1. If any argument's value is null, returns null.

Usage

The parent object can be Category, Panel, or Group.

The child item for Category is Panel; the child item for Panel can be Group, LargeButton, SmallButton, CheckBox, and ComboBox; the child item for Group can be SmallButton, CheckBox, and ComboBox.

Examples

The following code example counts the panels in the "TestCategory" category and returns 2.

Long ll_Return, ll_Handle_Category, ll_Handle_panel

ll_Handle_Category = rbb_1.InsertCategoryFirst ( "TestCategory" )
ll_Handle_Panel = rbb_1.InsertPanelFirst ( ll_Handle_Category, "TestPanel1", "EmployeeSmall!" )
ll_Handle_Panel = rbb_1.InsertPanelLast ( ll_Handle_Category, "TestPanel2", "EmployeeSmall!" )
ll_Return = rbb_1.GetChildItemCount ( ll_Handle_Category )

See also

GetChildItemByIndex

GetItemByTag

GetItemParent