AddTabToolBar Method

Description

Syntax

Public Function AddTabToolBar( _
    ByVal Name As String _
) As TabToolBar

Parameters

Name: Title of the tabbed toolbar.

Return Type

Reference to the TabToolBar that was just added.

Remarks

A 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. 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. In the picture above, "Advanced", "Standard", "Other", and "User Tools" are all categories that were added to a Tabbed ToolBar.

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. When adding buttons/controls, the Category property for the new button/control must be set to the name of a category in the tabbed toolbar. After UpdateTabs is called, the buttons will be displayed in the appropriate category.

The appearance, color, and theme of the tabs used in the Tabbed Toolbar can be customized using the TabPaintManager property. Depending on which visual changes are made, the RedrawBar and RecalcLayout methods might be needed to update the tabbed toolbar.

The AllowReorder property is used to specify that the tabs in the tabbed toolbar can be reordered.

The MinimumWidth property specifies the minimum width the Tabbed Toolbar can be, regardless of how few items might be in a category.

Methods and properties unique to the Tabbed Toolbar are:

Example

Adding a Tabbed ToolBar