RemoveBarItemAndLinkAction Class

Removes a bar item from the BarManager.Items collection, and removes all links to this bar item from link holders (bars, submenus, menus, and so on).

Namespace: DevExpress.Xpf.Bars

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

NuGet Package: DevExpress.Wpf.Core

Declaration

C#
VB.NET

[Browsable(false)]
public class RemoveBarItemAndLinkAction :
    RemoveBarItemAction

<Browsable(False)>
Public Class RemoveBarItemAndLinkAction
    Inherits RemoveBarItemAction

Remarks

To specify a bar item you want to remove, use the inherited BarItemActionBase.ItemName or BarItemActionBase.ItemIndex property. The BarItemActionBase.ItemIndex property is in effect if the BarItemActionBase.ItemName property is not set.

XAML

<dxb:BarManagerActionContainer>
    <dxb:RemoveBarItemAndLinkAction ItemName="btnAbout"/>
    <!--...-->

Refer to the Bar Actions topic for more information.

Example

The following example removes an item from the Total Summary panel‘s context menu:

View Example

In XAML

Add the RemoveBarItemAndLinkAction object to the DataViewBase.TotalSummaryMenuCustomizations collection. Specify the BarItemActionBase.ItemName property with the menu item name from the DefaultSummaryMenuItemNames class.

Window1.xaml

<dxg:TableView.TotalSummaryMenuCustomizations>
    <dxb:RemoveBarItemAndLinkAction ItemName="{x:Static dxg:DefaultSummaryMenuItemNames.Customize}" />
</dxg:TableView.TotalSummaryMenuCustomizations>

In Code

Handle the DataViewBase.ShowGridMenu event.

MainWindow.xaml

<dxg:TableView ShowGridMenu="ShowGridMenu" />

MainWindow.xaml.cs
MainWindow.xaml.vb

void ShowGridMenu(object sender, GridMenuEventArgs e) {
    if (e.MenuType == GridMenuType.TotalSummary) {
        e.Customizations.Add(new RemoveAction { ElementName = DefaultSummaryMenuItemNames.Customize });
    }
}

Sub ShowGridMenu(sender As Object, e As GridMenuEventArgs)
    If e.MenuType = GridMenuType.TotalSummary Then
        e.Customizations.Add(New RemoveAction() With {.ElementName = DefaultSummaryMenuItemNames.Customize})
    End If
End Sub

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the RemoveBarItemAndLinkAction class.

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.

XAML

wpf-pivot-grid-create-context-menu-for-field-values/CS/WpfPivotGrid_CustomMenu/MainWindow.xaml#L42

<dxpg:PivotGridControl.HeaderMenuCustomizations>
    <dxb:RemoveBarItemAndLinkAction
    ItemName="{x:Static dxpg:DefaultMenuItemNames.FieldOrder}" />