NavBarGroup.IsExpanded Property

Gets or sets a value specifying whether the group is expanded. This is a dependency property.

Namespace: DevExpress.Xpf.NavBar

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

NuGet Packages: DevExpress.WindowsDesktop.Wpf.NavBar, DevExpress.Wpf.Navigation

Declaration

C#

public bool IsExpanded { get; set; }

VB.NET

Public Property IsExpanded As Boolean

Property Value

Type	Description
Boolean	true if the group is expanded, otherwise false.

Remarks

Use the IsExpanded property to expand and collapse groups.

Changing a group’s expanded state results in generating the ExplorerBarView.GroupExpandedChanging and ExplorerBarView.GroupExpandedChanged events.

Note

The IsExpanded property is in effect only for the Explorer Bar view.

Example

This example demonstrates how the NavBarControl.Groups collection can be iterated programmatically, and the expanded state of groups can be toggled by using a group’s NavBarGroup.IsExpanded property.

The result is demonstrated by the following image.

View Example

Window1.xaml.vb

Private Sub button1_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    For i As Integer = 0 To navBarControl1.Groups.Count - 1
        Dim currentGroup As NavBarGroup = navBarControl1.Groups(i)
        currentGroup.IsExpanded = Not currentGroup.IsExpanded
    Next i

End Sub

Window1.xaml

<DockPanel>
    <Button Height="23" HorizontalAlignment="Left" Name="button1" VerticalAlignment="Top" Click="button1_Click">Toggle Group States</Button>
    <dxn:NavBarControl Name="navBarControl1">
        <dxn:NavBarControl.Groups>
            <dxn:NavBarGroup Header="Group1">
                <dxn:NavBarItem>Item1</dxn:NavBarItem>
                <dxn:NavBarItem>Item2</dxn:NavBarItem>
            </dxn:NavBarGroup>
            <dxn:NavBarGroup Header="Group2" IsExpanded="False">
                <dxn:NavBarItem>Item1</dxn:NavBarItem>
                <dxn:NavBarItem>Item2</dxn:NavBarItem>
                <dxn:NavBarItem>Item3</dxn:NavBarItem>
            </dxn:NavBarGroup>
            <dxn:NavBarGroup Header="Group3">
                <dxn:NavBarItem>Item1</dxn:NavBarItem>
                <dxn:NavBarItem>Item2</dxn:NavBarItem>
            </dxn:NavBarGroup>
        </dxn:NavBarControl.Groups>
        <dxn:NavBarControl.View>
            <dxn:ExplorerBarView />
        </dxn:NavBarControl.View>
    </dxn:NavBarControl>
</DockPanel>

Window1.xaml.cs

private void button1_Click(object sender, RoutedEventArgs e){
    for (int i = 0; i < navBarControl1.Groups.Count; i++){
        NavBarGroup currentGroup = navBarControl1.Groups[i];
        currentGroup.IsExpanded = !currentGroup.IsExpanded;
    }

}

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the IsExpanded 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.

XAML

how-to-iterate-through-groups-and-toggle-their-expanded-state-e1622/CS/ToggleGroupExpandedState/Window1.xaml#L11

</dxn:NavBarGroup>
<dxn:NavBarGroup Header="Group2" IsExpanded="False">
    <dxn:NavBarItem>Item1</dxn:NavBarItem>

C#

how-to-iterate-through-groups-and-toggle-their-expanded-state-e1622/CS/ToggleGroupExpandedState/Window1.xaml.cs#L29

    NavBarGroup currentGroup = navBarControl1.Groups[i];
    currentGroup.IsExpanded = !currentGroup.IsExpanded;
}

VB.NET

how-to-iterate-through-groups-and-toggle-their-expanded-state-e1622/VB/ToggleGroupExpandedState/Window1.xaml.vb#L30

    Dim currentGroup As NavBarGroup = navBarControl1.Groups(i)
    currentGroup.IsExpanded = Not currentGroup.IsExpanded
Next i