Bar

TabFormControl Class

The TabForm's header.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

public class TabFormControl :
    TabFormControlBase,
    IBackstageViewOwner,
    IDocumentAdapterFactory
Public Class TabFormControl
    Inherits TabFormControlBase
    Implements IBackstageViewOwner,
               IDocumentAdapterFactory

Related API Members

The following members accept/return TabFormControl objects:

Remarks

The TabFormControl is a TabForm's header that displays tabs and custom buttons.

TabFormControl

To get access to the TabFormControl embedded in a TabForm, use the TabForm.TabFormControl property in code, or click the control on the form in the Windows Forms designer.

The TabFormControl displays the Add Page button (TabFormControlBase.ShowAddPageButton) that allows end-users to add new pages at runtime.

End-users are allowed to rearrange tabbed pages, or drag a page out of the current form for display in a new separate form. See the TabFormControlBase.AllowMoveTabs and TabFormControlBase.AllowMoveTabsToOuterForm settings that control this behavior.

You can add custom buttons (Bar Items) to the title bar, and to the left and to the right of the tabs.

TabForm_CustomButtons

In code, you can add these buttons using the TabFormControlBase.TitleItemLinks, TabFormControlBase.TabLeftItemLinks and TabFormControlBase.TabRightItemLinks collections.

You can show tabs directly in the title bar by setting the TabFormControlBase.ShowTabsInTitleBar property to true.

TabForm_TabsOnTop

In this case, buttons from the TabFormControlBase.TitleItemLinks collection are hidden.

NOTE

Do not add a separate BarManager to the TabFormControl. The TabFormControl provides its own TabFormControl.Manager (a BarManager class descendant), which manipulates custom buttons you add to the TabFormControlBase.TitleItemLinks, TabFormControlBase.TabLeftItemLinks and TabFormControlBase.TabRightItemLinks collections.

To add a toolbar to a tabbed page, create a User Control, add a BarManager to the User Control and then add this User Control to the target tabbed page.

Inheritance

Object
MarshalByRefObject
Component
Control
DevExpress.XtraBars.Controls.CustomControl
DevExpress.XtraBars.Controls.CustomLinksControl
TabFormControlBase
TabFormControl
See Also