InsertCategory Method

Description

Inserts a category into the Tabbed Toolbar.

Syntax

Public Function InsertCategory( _
    ByVal [Index](#) As Long, _
    ByVal [Category](#) As String _
) As [TabControlItem](XtremeCommandBars~TabControlItem.md)

Parameters

Index: Position within the collection of categories to insert the new category.
Category: Name of the category to add. This string will also be used as the tab button caption.

Return Type

Returns a TabControlItem object. This is a reference to the tab button that is used to display the category within the Tabbed ToolBar.

Remarks

The Tabbed Toolbar consists of one or more categories, each category has its own tab. Tabs are used to display the corresponding category. Categories can be thought of as separate toolbars inside the Tabbed Toolbar. Buttons and other controls can then be added to each category.

The InsertCategory method is used to insert a category into a tabbed toolbar. The InsertCategory method returns a TabControlItem, which is the tab used to access the category.

The UpdateTabs method must be called after adding buttons/controls to a category in the tabbed toolbar so the new control can be added to the appropriate Category.

Example

TabToolBar Sample