DataNavigationControl Class

Provides a data navigation panel containing buttons that correspond to keys, which are used to browse to first-level groups corresponding to the value represented by the keys.

Syntax

Visual Basic
C#

'Declaration
 
<TemplateVisualStateAttribute(GroupName="CommonStates", Name="Disabled")>
<DefaultEventAttribute("OnItemsChanged")>
<DefaultPropertyAttribute("Items")>
<ContentPropertyAttribute("Items")>
<StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=System.Windows.FrameworkElement)>
<LocalizabilityAttribute(LocalizationCategory.None, Readability=Readability.Unreadable)>
<XmlLangPropertyAttribute("Language")>
<UsableDuringInitializationAttribute(True)>
<RuntimeNamePropertyAttribute("Name")>
<UidPropertyAttribute("Uid")>
<TypeDescriptionProviderAttribute(MS.Internal.ComponentModel.DependencyObjectProvider)>
<NameScopePropertyAttribute("NameScope", System.Windows.NameScope)>
Public Class DataNavigationControl 
   Inherits System.Windows.Controls.ItemsControl

'Usage
 
Dim instance As DataNavigationControl

[TemplateVisualState(GroupName="CommonStates", Name="Disabled")]
[DefaultEvent("OnItemsChanged")]
[DefaultProperty("Items")]
[ContentProperty("Items")]
[StyleTypedProperty(Property="ItemContainerStyle", StyleTargetType=System.Windows.FrameworkElement)]
[Localizability(LocalizationCategory.None, Readability=Readability.Unreadable)]
[XmlLangProperty("Language")]
[UsableDuringInitialization(true)]
[RuntimeNameProperty("Name")]
[UidProperty("Uid")]
[TypeDescriptionProvider(MS.Internal.ComponentModel.DependencyObjectProvider)]
[NameScopeProperty("NameScope", System.Windows.NameScope)]
public class DataNavigationControl : System.Windows.Controls.ItemsControl

Remarks

The DataNavigationControl is part of the ListBoxGroupHeader. By default it is opened by clicking on the button seen in the following image, before next to the up- and down-arrow buttons.

Clicking on this button opens a panel containing the keys' buttons. The following DataNavigationControl is the result of setting its DataNavigationConfiguration attached property to an instance of AlphabeticalDataNavigationConfiguration.

Example

XAML

<sllb:ListBox x:Name="listBox"
              ItemsSource="{Binding}"
              ItemTemplate="{StaticResource orderListBoxItemTemplate}"
              ToolPaneVisibility="Visible">

...


  <sllb:DataNavigationControl.DataNavigationConfiguration>
    <sllb:AlphabeticalDataNavigationConfiguration />
  </sllb:DataNavigationControl.DataNavigationConfiguration>
</sllb:ListBox>

Inheritance Hierarchy

System.Object
   System.Windows.Threading.DispatcherObject
      System.Windows.DependencyObject
         System.Windows.Media.Visual
            System.Windows.UIElement
               System.Windows.FrameworkElement
                  System.Windows.Controls.Control
                     System.Windows.Controls.ItemsControl
                        Xceed.Wpf.Controls.DataNavigationControl

Requirements

Target Platforms: Windows 11, Windows 10, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

DataNavigationControl Members
Xceed.Wpf.Controls Namespace