BarCustomContainerItem.ItemLinks Property

Provides access to links owned by the container item.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

C#

[XtraSerializableProperty(XtraSerializationVisibility.Collection, true, false, true, true, 0, XtraSerializationFlags.None)]
[Browsable(false)]
public virtual BarItemLinkCollection ItemLinks { get; }

VB.NET

<XtraSerializableProperty(XtraSerializationVisibility.Collection, True, False, True, True, 0, XtraSerializationFlags.None)>
<Browsable(False)>
Public Overridable ReadOnly Property ItemLinks As BarItemLinkCollection

Property Value

Type	Description
BarItemLinkCollection	A BarItemLinkCollection object containing links owned by the container item.

Remarks

Use the ItemLinks property to add, remove or modify the link collection for a container item.

It is possible to use the property to manage an item collection for BarSubItem and BarLinkContainerItem items. For BarListItem items, use the BarListItem.Strings property to customize child items.

For BarMdiChildrenListItem and BarToolbarsListItem items, the ItemLinks collection is populated and maintained automatically. Modifying the collection has no effect.

Each element of the collection is a BarItemLink descendant. Its BarItemLink.Item property refers to the bar item that this link represents.

Example

The following code shows how to add two items to a container item (BarLinkContainerItem1). For this purpose, the BarCustomContainerItem.ItemLinks property is used.

C#

//Add the iFont bar item
BarLinkContainerItem1.ItemLinks.Add(iFont);
//Add the iFontColor bar item
BarLinkContainerItem1.ItemLinks.Add(iFontColor);

VB.NET

'Add the iFont bar item
BarLinkContainerItem1.ItemLinks.Add(iFont)
'Add the iFontColor bar item
BarLinkContainerItem1.ItemLinks.Add(iFontColor)

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ItemLinks property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-create-a-component-which-automatically-create-a-menu-for-all-registered-skins-e2058/CS/WindowsApplication1/MySkinsBarMenuHelper.cs#L66

{
    foreach (BarItemLink item in subItem.ItemLinks)
    {

XAF_how-to-create-a-custom-a-winforms-standard-template-t196002/CS/CustomizeWinFormsTemplateExample.Win/DetailForm1.cs#L37

    barManager.ForceLinkCreate();
    statusMessagesHelper = new StatusMessagesHelper(barContainerStatusMessages.ItemLinks);
}

how-to-enumerate-buttons-in-a-menu-or-on-a-toolbar-e599/CS/Form1.cs#L930

    if(link.Item is BarSubItem)
        FillItemBranch(node, ((BarSubItem)link.Item).ItemLinks);
}

VB.NET

how-to-create-a-component-which-automatically-create-a-menu-for-all-registered-skins-e2058/VB/WindowsApplication1/MySkinsBarMenuHelper.vb#L71

Private Sub CreateOfficeSkins(ByVal subItem As BarSubItem)
    For Each item As BarItemLink In subItem.ItemLinks
        If item.Caption.IndexOf("Office") > -1 Then

XAF_how-to-create-a-custom-a-winforms-standard-template-t196002/VB/CustomizeWinFormsTemplateExample.Win/DetailForm1.vb#L38

    barManager.ForceLinkCreate()
    statusMessagesHelper = New StatusMessagesHelper(barContainerStatusMessages.ItemLinks)
End Sub

how-to-enumerate-buttons-in-a-menu-or-on-a-toolbar-e599/VB/Form1.vb#L806

If TypeOf link.Item Is BarSubItem Then
    FillItemBranch(node, (CType(link.Item, BarSubItem)).ItemLinks)
End If