AddBarItemLinkAction Class

Adds a bar item link to the link container (a bar, a menu, etc.).

Namespace: DevExpress.Xpf.Bars

Assembly: DevExpress.Xpf.Core.v24.1.dll

NuGet Package: DevExpress.Wpf.Core

Declaration

C#

[Browsable(false)]
public class AddBarItemLinkAction :
    InsertBarItemLinkAction

VB.NET

<Browsable(False)>
Public Class AddBarItemLinkAction
    Inherits InsertBarItemLinkAction

Remarks

A link container to which a bar item link is added can be identified via these properties:

• BarItemLinkActionBase.Target - Identifies the target link container by its name.
• BarItemLinkActionBase.TargetType - Identifies the target link container by its type. This property allows you to add a bar item link to the main menu (a bar whose Bar.IsMainMenu option is enabled) or status bar (a bar whose Bar.IsStatusBar option is enabled) without knowing the names of the corresponding bar objects.

The following code adds a link to the btnAbout item to the main menu:

XAML

<dxb:BarButtonItem x:Name="btnAbout" Content="About" ItemClick="btnAbout_ItemClick"/>
<!--...-->
<dxb:AddBarItemLinkAction TargetType="MainMenu">
    <dxb:AddBarItemLinkAction.ItemLink>
        <dxb:BarButtonItemLink x:Name="myBarItemLink" BarItemName="btnAbout"/>
    </dxb:AddBarItemLinkAction.ItemLink>
</dxb:AddBarItemLinkAction>

The BarItemLinkActionBase.Target and BarItemLinkActionBase.TargetType properties are attached properties. They can be used as shown in the following example. In the code below, a BarButtonItemLink object, referring to a btnExit item, is created and added to the ‘menuFile’ menu:

XAML

<dxb:BarButtonItemLink x:Name="btnExitLink" BarItemName="btnExit" dxb:BarItemLinkActionBase.Target="menuFile"/>

See Bar Actions to learn more.

Implements

IControllerAction

Inheritance

Object

DispatcherObject

DependencyObject

ContentElement

FrameworkContentElement

DXFrameworkContentElement

BarManagerControllerActionBase

BarItemLinkActionBase

InsertBarItemLinkAction

AddBarItemLinkAction