AddBarItemLinkAction Class

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

Namespace: DevExpress.Xpf.Bars

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

Declaration

C#

public class AddBarItemLinkAction :
    InsertBarItemLinkAction

VB.NET

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 Customizing Bars via Actions to learn more.

Inheritance

Object

DispatcherObject

DependencyObject

BarManagerControllerActionBase

BarItemLinkActionBase

InsertBarItemLinkAction

AddBarItemLinkAction