AddBarItemLinkAction Class

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

Assembly : DevExpress.Xpf.Core.v25.2.dll

Declaration

C#
VB.NET

csharp

[Browsable(false)]
public class AddBarItemLinkAction :
    InsertBarItemLinkAction

<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

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

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