InsertCategoryLast

Description

Inserts a category as the last item in the RibbonBar control.

Applies to

RibbonBar controls

Syntax

controlname.InsertCategoryLast ( String Text )
controlname.InsertCategoryLast ( RibbonCategoryItem Item )

Argument

Description

controlname

The name of the RibbonBar control.

Text

The title of the category to be inserted.

Item

A category 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 the "MyCategory3" category as the last category in the ribbon bar.

Long ll_Handle

ll_Handle = rbb_1.InsertCategoryLast ("MyCategory3")

Example 2

This example also inserts the "MyCategory3" category as the last category in the ribbon bar. It first defines a category item with various properties (including Text, Tag etc.) and then inserts it as the last category in the ribbon bar.

Long ll_Handle
RibbonCategoryItem lr_Category

lr_Category.Text = "MyCategory3"
lr_Category.Tag = "MyCategory3"
ll_Handle = rbb_1.InsertCategoryLast (lr_Category)

See also

InsertCategory

InsertCategoryFirst

DeleteCategory

SetCategory

GetCategory

GetCategoryByIndex

GetCategoryCount

SetActiveCategory

GetActiveCategory