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.v19.1.dll

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#

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

miAllowFormSkins = new CheckBarItem(Manager, "Allow Form Skins", OnSwitchFormSkinStyle_Click);
miLookAndFeel.ItemLinks.Add(miAllowFormSkins);
miLookAndFeel.ItemLinks.Add(new CheckBarItemWithStyle(Manager, "&Flat", OnSwitchStyle_Click, ActiveLookAndFeelStyle.Flat, LookAndFeelStyle.Flat)).BeginGroup = true;

how-to-place-a-button-or-editor-in-the-forms-title-bar-e3502/CS/WindowsApplication1/MainForm.cs#L21

DevExpress.XtraBars.Ribbon.RibbonBarManager manager = TitleBarToolBar.Ribbon.Manager;
TitleBarToolBar.ItemLinks.Add(new BarButtonItem(manager, "Test"));
RepositoryItemTextEdit riTextEdit = new RepositoryItemTextEdit();

how-to-share-a-single-barmanager-between-different-usercontrols-e1927/CS/B143239/PropertiesUserControl.cs#L30

categoriesItem.CheckedChanged += new ItemClickEventHandler(OnBarCheckItemCheckedChanged);
bar.ItemLinks.Add(categoriesItem);

how-to-create-the-main-menu-at-runtime-e728/CS/Form1.cs#L114

barManager1.Items.Add(file);
menu.ItemLinks.Add(file);

how-to-display-spellchecker-context-menu-for-standard-text-controls-textbox-and-richtextbox-t236002/CS/SpellCheckerMenuExample/Form1.cs#L51

    item.ItemClick += new ItemClickEventHandler(OnPopupMenuItemClick);
    popupMenu1.ItemLinks.Add(item);
}

VB.NET

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

miAllowFormSkins = New CheckBarItem(Manager, "Allow Form Skins", AddressOf OnSwitchFormSkinStyle_Click)
miLookAndFeel_Renamed.ItemLinks.Add(miAllowFormSkins)
miLookAndFeel_Renamed.ItemLinks.Add(New CheckBarItemWithStyle(Manager, "&Flat", AddressOf OnSwitchStyle_Click, ActiveLookAndFeelStyle.Flat, LookAndFeelStyle.Flat)).BeginGroup = True

how-to-place-a-button-or-editor-in-the-forms-title-bar-e3502/VB/WindowsApplication1/MainForm.vb#L20

Dim manager As DevExpress.XtraBars.Ribbon.RibbonBarManager = TitleBarToolBar.Ribbon.Manager
TitleBarToolBar.ItemLinks.Add(New BarButtonItem(manager, "Test"))
Dim riTextEdit As New RepositoryItemTextEdit()

how-to-share-a-single-barmanager-between-different-usercontrols-e1927/VB/B143239/PropertiesUserControl.vb#L34

AddHandler categoriesItem.CheckedChanged, AddressOf OnBarCheckItemCheckedChanged
bar.ItemLinks.Add(categoriesItem)

how-to-create-the-main-menu-at-runtime-e728/VB/Form1.vb#L108

barManager1.Items.Add(file)
menu.ItemLinks.Add(file)

how-to-display-spellchecker-context-menu-for-standard-text-controls-textbox-and-richtextbox-t236002/VB/SpellCheckerMenuExample/Form1.vb#L46

    AddHandler item.ItemClick, AddressOf OnPopupMenuItemClick
    popupMenu1.ItemLinks.Add(item)
Next command