Back to Devexpress

RemoveBarItemAndLinkAction Class

wpf-devexpress-dot-xpf-dot-bars-f62306ef.md

latest6.0 KB
Original Source

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.v25.2.dll

NuGet Package : DevExpress.Wpf.Core

Declaration

csharp
[Browsable(false)]
public class RemoveBarItemAndLinkAction :
    RemoveBarItemAction
vb
<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: Customize the GridControl's Context Menu

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.

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

In Code

Handle the DataViewBase.ShowGridMenu event.

xaml
<dxg:TableView ShowGridMenu="ShowGridMenu"/>
csharp
void ShowGridMenu(object sender, GridMenuEventArgs e) {
    if (e.MenuType == GridMenuType.TotalSummary) {
        e.Customizations.Add(new RemoveAction { ElementName = DefaultSummaryMenuItemNames.Customize });
    }
}
vb
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 snippets (auto-collected from DevExpress Examples) contain references 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.

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

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

how-to-customize-a-grids-context-menu-e1925/CS/Window1.xaml#L19

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

Implements

IControllerAction

Inheritance

Object DispatcherObject DependencyObject ContentElement FrameworkContentElement DXFrameworkContentElement BarManagerControllerActionBase BarItemActionBase RemoveBarItemAction RemoveBarItemAndLinkAction

See Also

RemoveBarItemAndLinkAction Members

Bar Actions

DevExpress.Xpf.Bars Namespace