AddDialogBar Method

Description

The AddDialogBar method adds a Dialog Bar to the Command Bars collection of controls.

Syntax

Public Function AddDialogBar( _
    ByVal [Name](#) As String, _
    ByVal [Position](#) As [XTPBarPosition](XtremeCommandBars~Enumerations~XTPBarPosition_EN.md) _
) As [DialogBar](XtremeCommandBars~DialogBar.md)

Parameters

Name
Name of the Dialog Bar. This will be the Title given to the Dialog Bar.
Position
The initial position the Dialog Bar will be docked when the application is started. The possible values are:

Value	Description
xtpBarTop	The bar is docked to the top edge of the form.
xtpBarBottom	The bar is docked to the bottom edge of the form.
xtpBarLeft	The bar is docked to the left edge of the form.
xtpBarRight	The bar is docked to the right edge of the form.
xtpBarFloating	The bar is a floating command bar.
xtpBarPopup	Not Used for dialog bar.
xtpBarListBox	Not Used for dialog bar.
xtpBarComboBoxGalleryPopup	The command bar will be displayed as a gallery.

Return Type

Pointer to the DialogBar.

Remarks

The Dialog Bar has both the characteristics of a toolbar and a dialog box. The Dialog Bar acts like a toolbar but can contain any object with an hWnd. When adding multiple controls, controls can be grouped by placing them in a Picture Box or Form, and then adding them to the Dialog Bar.