Back to Devexpress

BarItemLinkSeparator Class

wpf-devexpress-dot-xpf-dot-bars-25f0bb1d.md

latest7.9 KB
Original Source

BarItemLinkSeparator Class

Represents a separator between item links.

Namespace : DevExpress.Xpf.Bars

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

NuGet Package : DevExpress.Wpf.Core

Declaration

csharp
public class BarItemLinkSeparator :
    BarItemLink
vb
Public Class BarItemLinkSeparator
    Inherits BarItemLink

Remarks

To create a separator between bar item links, you need to create a BarItemLinkSeparator object and add it to the ItemLinks collection of a container (a bar, popup menu, sub-menu, etc).

Note: Unlike regular bar item links, the BarItemLinkSeparator class does not have a matching bar item class.

Example

This example shows how to create bar button items (BarButtonItem objects) and add a link separator between them. The separator is created using the BarItemLinkSeparator class.

The following image shows the result:

View Example

xaml
<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
        xmlns:dxb="http://schemas.devexpress.com/winfx/2008/xaml/bars" 
        xmlns:dx="http://schemas.devexpress.com/winfx/2008/xaml/core" 
        x:Class="BarItemLinkSeparatorEx.Window1" 
        Title="Window1" Height="300" Width="300">
    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto" />
            <RowDefinition Height="*"/>
        </Grid.RowDefinitions>

        <dxb:BarContainerControl Grid.Row="0">
            <dxb:ToolBarControl Caption="Main Toolbar" BarItemHorizontalIndent="10">
                <dxb:BarButtonItem Content="Undo" Glyph="{dx:DXImage Image=undo16x16.png}" ItemClick="itemClick"/>
                <dxb:BarButtonItem Content="Redo" Glyph="{dx:DXImage Image=redo16x16.png}" ItemClick="itemClick"/>
                <dxb:BarItemLinkSeparator />
                <dxb:BarButtonItem Content="Copy" Glyph="{dx:DXImage Image=copy16x16.png}" ItemClick="itemClick"/>
                <dxb:BarButtonItem Content="Paste" Glyph="{dx:DXImage Image=paste16x16.png}" ItemClick="itemClick"/>
            </dxb:ToolBarControl>
        </dxb:BarContainerControl>

        <RichTextBox Grid.Row="1"/>

    </Grid>
</Window>
csharp
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;

namespace BarItemLinkSeparatorEx {
    /// <summary>
    /// Interaction logic for Window1.xaml
    /// </summary>
    public partial class Window1 : Window {
        public Window1() {
            InitializeComponent();
        }

        // Respond to clicking the bar items
        private void itemClick(object sender, DevExpress.Xpf.Bars.ItemClickEventArgs e) {
            MessageBox.Show("Item " + e.Item.Content + " has been clicked.");
        }

    }
}
vb
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Text
Imports System.Windows
Imports System.Windows.Controls
Imports System.Windows.Data
Imports System.Windows.Documents
Imports System.Windows.Input
Imports System.Windows.Media
Imports System.Windows.Media.Imaging
Imports System.Windows.Navigation
Imports System.Windows.Shapes

Namespace BarItemLinkSeparatorEx
    ''' <summary>
    ''' Interaction logic for Window1.xaml
    ''' </summary>
    Partial Public Class Window1
        Inherits Window

        Public Sub New()
            InitializeComponent()
        End Sub

        ' Respond to clicking the bar items
        Private Sub itemClick(ByVal sender As Object, ByVal e As DevExpress.Xpf.Bars.ItemClickEventArgs)
            MessageBox.Show("Item " & e.Item.Content & " has been clicked.")
        End Sub

    End Class
End Namespace

The following code snippets (auto-collected from DevExpress Examples) contain references to the BarItemLinkSeparator 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-create-a-ribboncontrol/CS/RibbonControl_Ex/MainWindow.xaml#L34

xml
<dxb:BarButtonItemLink BarItemName="bOpen"/>
<dxb:BarItemLinkSeparator/>
<dxb:BarSplitButtonItemLink BarItemName="sbSave"/>

mvvm-application-with-wpf-bars/CS/Bars_in_MVVM_Application/MainWindow.xaml#L95

xml
<dxb:BarButtonItemLink BarItemName="removeItem"/>
<dxb:BarItemLinkSeparator/>
<dxb:BarCheckItemLink BarItemName="completed"/>

wpf-rich-text-editor-customize-context-menu/CS/ContextMenuCustomization/MainWindow.xaml#L52

xml
</dxb:BarButtonItemLink>
    <dxb:BarItemLinkSeparator dxb:BarItemLinkActionBase.ItemLinkIndex="2"></dxb:BarItemLinkSeparator>
</dxre:RichEditMenuCustomization>

wpf-dock-layout-manager-define-prism-regions-for-dock-layout-manager-elements/CS/PrismOnDXDocking/Shell.xaml#L55

xml
<dxb:BarCheckItemLink BarItemName="bMDIStyle" />
<dxb:BarItemLinkSeparator />
<dxb:BarButtonItemLink BarItemName="bCascade" />

reporting-wpf-customize-context-menus-in-report-designer/CS/CustomizeContextMenus/MainWindow.xaml#L25

xml
<dxb:InsertAction.Element>
    <dxb:BarItemLinkSeparator/>
</dxb:InsertAction.Element>

Implements

IControllerAction

Inheritance

Object DispatcherObject DependencyObject ContentElement FrameworkContentElement BarItemLinkBase BarItemLink BarItemLinkSeparator

See Also

BarItemLinkSeparator Members

Items and Links

DevExpress.Xpf.Bars Namespace