RibbonControl.PageHeaderItemLinks Property

Gets a collection of bar item links displayed at the right edge of the control in the same row with tab headers.

Namespace: DevExpress.XtraBars.Ribbon

Assembly: DevExpress.XtraBars.v18.2.dll

Declaration

C#

[Browsable(false)]
[InheritableCollection]
[SkipRuntimeSerialization]
public RibbonPageHeaderItemLinkCollection PageHeaderItemLinks { get; }

VB.NET

<Browsable(False)>
<InheritableCollection>
<SkipRuntimeSerialization>
Public ReadOnly Property PageHeaderItemLinks As RibbonPageHeaderItemLinkCollection

Property Value

Type	Description
DevExpress.XtraBars.Ribbon.RibbonPageHeaderItemLinkCollection	A DevExpress.XtraBars.Ribbon.RibbonPageHeaderItemLinkCollection object representing the collection of bar item links.

Remarks

To display bar item links at the right edge of the control in the same row with tab headers, add them to the PageHeaderItemLinks collection.

To display bar items within the Quick Access Toolbar, add them to the RibbonQuickAccessToolbar.ItemLinks collection. To display bar items within a Ribbon Page Group, add them to the RibbonPageGroup.ItemLinks collection.

Example

The following example demonstrates how to display two buttons in the same row with a RibbonControl’s tab headers. In the example, two buttons are created and added to the RibbonControl.PageHeaderItemLinks collection:

C#

using DevExpress.XtraBars;

BarButtonItem itemBackNav = RibbonControl1.Items.CreateButton("Backward");
itemBackNav.ImageIndex = 10;
itemBackNav.ItemClick += new ItemClickEventHandler(itemBackNav_ItemClick);
BarButtonItem itemFrwNav = RibbonControl1.Items.CreateButton("Forward");
itemFrwNav.ItemClick += new ItemClickEventHandler(itemFrwNav_ItemClick);
itemFrwNav.ImageIndex = 11;
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
AddHandler itemBackNav.ItemClick, AddressOf itemBackNav_ItemClick
Dim itemFrwNav As BarButtonItem = RibbonControl1.Items.CreateButton("Forward")
AddHandler itemFrwNav.ItemClick, AddressOf itemFrwNav_ItemClick
itemFrwNav.ImageIndex = 11
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