InsertGroupFirst

Description

Inserts a group as the first item in the panel.

Applies to

RibbonBar controls

Syntax

controlname.InsertGroupFirst ( Long PanelHandle )
controlname.InsertGroupFirst ( Long PanelHandle, RibbonGroupItem Item )

Argument

Description

controlname

The name of the RibbonBar control.

PanelHandle

The handle of the panel into which you want to insert a group.

Item

A group item to be inserted.


Return value

Long.

Returns the handle of the inserted item if it succeeds and -1 if an error occurs. If any argument's value is null, returns null.

Example 1

This example inserts a group as the first item in the "MyPanel" panel.

Long ll_Handle_Category, ll_Handle_Panel, ll_Handle_Group

ll_Handle_Category = rbb_1.InsertCategoryFirst ("MyCategory")
ll_Handle_Panel = rbb_1.InsertPanelFirst (ll_Handle_Category, "MyPanel", "AddSmall!")
ll_Handle_Group = rbb_1.InsertGroupFirst (ll_Handle_Panel)

Example 2

This example also inserts a group as the first item in the "MyPanel" panel. It defines a group item lr_Group and then inserts it as the first item in the "MyPanel" panel.

Long ll_Handle_Category, ll_Handle_Panel, ll_Handle_Group
RibbonGroupItem lr_Group

ll_Handle_Category = rbb_1.InsertCategoryFirst ("MyCategory")
ll_Handle_Panel = rbb_1.InsertPanelFirst (ll_Handle_Category, "MyPanel", "AddSmall!")
ll_Handle_Group = rbb_1.InsertGroupFirst (ll_Handle_Panel, lr_Group)

See also

InsertGroup

InsertGroupLast

DeleteGroup

SetGroup

GetGroup

GetChildItemByIndex