How to: Add Bar Items to the Tab Header Area

• Nov 13, 2018
• 2 minutes to read

You can display custom buttons in-line with tab headers. The buttons can be aligned near to the tab headers (left aligned) or near to the ribbon edge (right aligned).

To display a custom button in the tab header area:

• use the CreateButton(String) method to create a button;
• use the Alignment property to align the button near to tab headers or the ribbon edge;
• you can also set the VisibleInSearchMenu property to false to hide the button in the Search Menu;
• add the button to the PageHeaderItemLinks collection.

In the Ribbon Simple Pad demo, the ribbon displays the Share button aligned to the right. The example below shows how to add the Backward and Forward buttons.

C#

using DevExpress.XtraBars;

BarButtonItem itemBackNav = RibbonControl1.Items.CreateButton("Backward");
itemBackNav.ImageIndex = 10;
itemBackNav.VisibleInSearchMenu = false;
itemBackNav.Alignment = BarItemLinkAlignment.Left;
itemBackNav.ItemClick += new ItemClickEventHandler(itemBackNav_ItemClick);
BarButtonItem itemFrwNav = RibbonControl1.Items.CreateButton("Forward");
itemFrwNav.ItemClick += new ItemClickEventHandler(itemFrwNav_ItemClick);
itemFrwNav.ImageIndex = 11;
itemFrwNav.VisibleInSearchMenu = false;
itemFrwNav.Alignment = BarItemLinkAlignment.Left;
RibbonControl1.PageHeaderItemLinks.AddRange(new BarItem[] { itemBackNav, itemFrwNav});

void itemFrwNav_ItemClick(object sender, ItemClickEventArgs e) {
    //...
}

void itemBackNav_ItemClick(object sender, ItemClickEventArgs e) {
    //...
}

VB.NET

Imports DevExpress.XtraBars

Dim itemBackNav As BarButtonItem = RibbonControl1.Items.CreateButton("Backward")
itemBackNav.ImageIndex = 10
itemBackNav.VisibleInSearchMenu = False
itemBackNav.Alignment = BarItemLinkAlignment.Left
AddHandler itemBackNav.ItemClick, AddressOf itemBackNav_ItemClick
Dim itemFrwNav As BarButtonItem = RibbonControl1.Items.CreateButton("Forward")
AddHandler itemFrwNav.ItemClick, AddressOf itemFrwNav_ItemClick
itemFrwNav.ImageIndex = 11
itemFrwNav.VisibleInSearchMenu = False;
itemFrwNav.Alignment = BarItemLinkAlignment.Left
RibbonControl1.PageHeaderItemLinks.AddRange(New BarItem() {itemBackNav, itemFrwNav})

Private Sub itemFrwNav_ItemClick(ByVal sender As Object, ByVal e As ItemClickEventArgs)
    '...
End Sub

Private Sub itemBackNav_ItemClick(ByVal sender As Object, ByVal e As ItemClickEventArgs)
    '...
End Sub