NavBarItem.Content Property

Gets or sets the item’s content. This is a dependency property.

Namespace: DevExpress.Xpf.NavBar

Assembly: DevExpress.Xpf.NavBar.v18.2.dll

Declaration

C#

public object Content { get; set; }

VB.NET

Public Property Content As Object

Property Value

Type	Description
Object	An object specifying the item’s content.

Remarks

Use the Content property to define the content of the item.

Note

The Content property is, by design, specified as the default property and the content property of an item. This, for example, allows you to declare item contents in XAML directly after an item declaration, without wrapping them into opening and closing NavBarItem.Content tags.

See the Item Content Model topic to learn more.

Example

This example demonstrates how items can be created and customized programmatically within a navbar group.

In this sample, images are defined for the group header and the third group item via the NavBarGroup.ImageSource and NavBarItem.ImageSource properties, respectively. The item image’s layout is customized by assigning the item’s NavBarItem.VisualStyle property with a specific style that makes use of the NavBarViewBase.LayoutSettings attached property’s LayoutSettings.ImageDocking setting.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-programmatically-create-a-navbarcontrol-with-groups-and-items-e1626.

Window1.xaml.cs

private void CreateGroup1(NavBarControl navBar){
    NavBarGroup group1 = new NavBarGroup();
    group1.Header = "Items";
    //Display an image within the group's header
    group1.ImageSource = new BitmapImage(new Uri("pack://application:,,,/Images/folder.png"));

    NavBarItem item1 = new NavBarItem();
    item1.Content = "Home";
    group1.Items.Add(item1);

    NavBarItem item2 = new NavBarItem();
    item2.Content = "Work";
    group1.Items.Add(item2);

    NavBarItem item3 = new NavBarItem();
    item3.Content = "Private";
    //Display an image within the item
    item3.ImageSource = new BitmapImage(new Uri("pack://application:,,,/Images/private.png"));
    //Change item image layout
    Style itemStyle = new Style();
    itemStyle.Setters.Add(new Setter(NavBarViewBase.LayoutSettingsProperty, new LayoutSettings() { ImageDocking = Dock.Right }));
    item3.VisualStyle = itemStyle;
    group1.Items.Add(item3);

    navBar.Groups.Add(group1);
}

Window1.xaml.vb

Private Sub CreateGroup1(ByVal navBar As NavBarControl)
    Dim group1 As New NavBarGroup()
    group1.Header = "Items"
    'Display an image within the group's header
    group1.ImageSource = New BitmapImage(New Uri("pack://application:,,,/Images/folder.png"))

    Dim item1 As New NavBarItem()
    item1.Content = "Home"
    group1.Items.Add(item1)

    Dim item2 As New NavBarItem()
    item2.Content = "Work"
    group1.Items.Add(item2)

    Dim item3 As New NavBarItem()
    item3.Content = "Private"
    'Display an image within the item
    item3.ImageSource = New BitmapImage(New Uri("pack://application:,,,/Images/private.png"))
    'Change item image layout
    Dim itemStyle As New Style()
    itemStyle.Setters.Add(New Setter(NavBarViewBase.LayoutSettingsProperty, New LayoutSettings() With {.ImageDocking = Dock.Right}))
    item3.VisualStyle = itemStyle
    group1.Items.Add(item3)

    navBar.Groups.Add(group1)
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Content property.

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.

C#

how-to-provide-keyboard-navigation-in-navbar-e3809/CS/NavBarAttachedProperty.Example/MainWindow.xaml#L49

<dxn:NavBarGroup.Items>
    <dxn:NavBarItem Content="Item_1.1"/>
    <dxn:NavBarItem Content="Item_1.2"/>

how-to-create-a-custom-theme-for-dxnavbar-for-wpf-e1454/VB/Window1.xaml#L53

<dxn:NavBarGroup Header="Group1" ImageSource="{StaticResource groupImage}">
    <dxn:NavBarItem Content="Item1" IsEnabled="False"
                    ImageSource="{StaticResource itemImage}" />

alternative-theme-for-the-explorerbar-view-e2006/VB/Window1.xaml#L44

<dxn:NavBarGroup Header="Group1">
    <dxn:NavBarItem Content="Item1" ImageSource="{StaticResource image1}" />
    <dxn:NavBarItem Content="Item2" ImageSource="{StaticResource image2}" />

how-to-add-a-draganddrop-capability-to-navbarcontrol-t164276/CS/NavBarDragDropExample/MainWindow.xaml#L16

<dxn:NavBarGroup Header="Some Group 1">
    <dxn:NavBarItem Content="Item 1"/>
    <dxn:NavBarItem Content="Item 2"/>

how-to-adjust-visible-group-headers-and-overflow-panel-in-navigationpaneview-t329561/VB/NavBarExample/MainWindow.xaml#L23

<dxn:NavBarGroup Header="Sales">
    <dxn:NavBarItem Content="John"/>
    <dxn:NavBarItem Content="Mark"/>

VB.NET

how-to-programmatically-create-a-navbarcontrol-with-groups-and-items-e1626/VB/CreateNavBarControlViaCode/Window1.xaml.vb#L48

Dim item1 As New NavBarItem()
item1.Content = "Home"
group1.Items.Add(item1)

how-to-apply-conditional-formatting-to-a-range-of-cells-wpf-spreadsheet-e4968/VB/ConditionalFormatting_WPF_Examples_VB/MainWindow.xaml.vb#L40

If item IsNot Nothing Then
    Dim example As SpreadsheetExample = TryCast(item.Content, SpreadsheetExample)
    If example IsNot Nothing Then

wpf-spreadsheetcontrol-examples-e4975/VB/SpreadsheetControl_WPF_Examples/MainWindow.xaml.vb#L41

If item IsNot Nothing Then
    Dim example As SpreadsheetExample = TryCast(item.Content, SpreadsheetExample)
    If example IsNot Nothing Then

wpf-spreadsheetcontrol-api-part-1-e4938/VB/SpreadsheetControl_WPF_API/MainWindow.xaml.vb#L43

End If
Dim example As SpreadsheetExample = TryCast(item.Content, SpreadsheetExample)
If example Is Nothing Then

wpf-spreadsheetcontrol-api-part-2-e4944/VB/SpreadsheetControl_WPF_API_Part02/MainWindow.xaml.vb#L28

If item IsNot Nothing Then
    Dim example As SpreadsheetExample = TryCast(item.Content, SpreadsheetExample)
    If example IsNot Nothing Then