BarItemLinkCollection.Add(BarItem) Method

Creates a link to the specified bar item and adds it to the end of the collection.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

public virtual BarItemLink Add(
    BarItem item
)

VB.NET

Public Overridable Function Add(
    item As BarItem
) As BarItemLink

Parameters

Name	Type	Description
item	BarItem	A BarItem descendant, for which a link is added to the collection.

Returns

Type	Description
BarItemLink	A BarItemLink object representing the link added.

Remarks

A bar item must belong to the BarManager’s BarManager.Items collection so that a link to it can be created and added to the collection. Otherwise, an exception will be raised.

To add several links to different bar items at once, see the BarItemLinkCollection.AddRange method.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Add(BarItem) method.

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#

winforms-dashboard-custom-properties/CS/WinForms-Dashboard-Custom-Properties/Modules/ChartScaleBreakModule.cs#L27

barItem = CreateBarItem("Scale Break", barImage);
group.ItemLinks.Add(barItem);
barItem.ItemClick += ChangeCustomPropertyValue;

winforms-richedit-customize-insert-merge-field-menu/CS/CustomInsertMergeFieldItem.cs#L78

    InsertMergeFieldMenuItem item = new CustomInsertMergeFieldMenuItem(RichEditControl, new MergeFieldName(fullColumnName));
    this.popupMenu.ItemLinks.Add(item);
}

winforms-spreadsheet-spell-check-cell-text/CS/SpreadsheetSpellchecking/Form1.cs#L54

    item.ItemClick += OnPopupMenu_ItemClick;
    itemLinks.Add(item);
}

winforms-dashboard-custom-items-extension/CS/CustomItemExtension/CustomItems/WebPageItem/WebPageItemExtensionModule.cs#L69

    urlBarItem.EditWidth = 150;
    group.ItemLinks.Add(urlBarItem);
}

VB.NET

winforms-dashboard-custom-properties/VB/WinForms-Dashboard-Custom-Properties/Modules/ChartScaleBreakModule.vb#L27

barItem = CreateBarItem("Scale Break", barImage)
group.ItemLinks.Add(barItem)
AddHandler barItem.ItemClick, AddressOf ChangeCustomPropertyValue

winforms-richedit-customize-insert-merge-field-menu/VB/CustomInsertMergeFieldItem.vb#L127

    Dim item As InsertMergeFieldMenuItem = New CustomInsertMergeFieldMenuItem(RichEditControl, New MergeFieldName(fullColumnName))
    popupMenu.ItemLinks.Add(item)
Else

winforms-spreadsheet-spell-check-cell-text/VB/SpreadsheetSpellchecking/Form1.vb#L59

    AddHandler item.ItemClick, AddressOf OnPopupMenu_ItemClick
    itemLinks.Add(item)
Next

winforms-dashboard-custom-items-extension/VB/CustomItemExtension/CustomItems/WebPageItem/WebPageItemExtensionModule.vb#L78

    urlBarItem.EditWidth = 150
    group.ItemLinks.Add(urlBarItem)
End Sub