Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Expand]Controls and Libraries
 [Expand]Common Features
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.DataAccess.UI.Design
  [Expand]DevExpress.DataAccess.UI.EntityFramework
  [Expand]DevExpress.DataAccess.UI.Excel
  [Expand]DevExpress.DataAccess.UI.Localization
  [Expand]DevExpress.DataAccess.UI.ObjectBinding
  [Expand]DevExpress.DataAccess.UI.Sql
  [Expand]DevExpress.DataAccess.UI.Wizard
  [Expand]DevExpress.DataAccess.UI.Wizard.Services
  [Expand]DevExpress.DataAccess.UI.Wizard.Views
  [Expand]DevExpress.DocumentView
  [Expand]DevExpress.DocumentView.Controls
  [Expand]DevExpress.LookAndFeel
  [Expand]DevExpress.LookAndFeel.Helpers
  [Expand]DevExpress.Skins
  [Expand]DevExpress.Snap
  [Expand]DevExpress.Snap.API.Native
  [Expand]DevExpress.Snap.Core
  [Expand]DevExpress.Snap.Core.API
  [Expand]DevExpress.Snap.Core.Fields
  [Expand]DevExpress.Snap.Core.Forms
  [Expand]DevExpress.Snap.Core.Options
  [Expand]DevExpress.Snap.Core.Services
  [Expand]DevExpress.Snap.Extensions
  [Expand]DevExpress.Snap.Extensions.Localization
  [Expand]DevExpress.Snap.Localization
  [Expand]DevExpress.Snap.Options
  [Expand]DevExpress.Snap.Services
  [Expand]DevExpress.Utils
  [Expand]DevExpress.Utils.Animation
  [Expand]DevExpress.Utils.Controls
  [Expand]DevExpress.Utils.Drawing
  [Expand]DevExpress.Utils.Menu
  [Expand]DevExpress.Utils.Taskbar
  [Expand]DevExpress.Utils.Taskbar.Core
  [Expand]DevExpress.Utils.UI.Localization
  [Expand]DevExpress.Utils.VisualEffects
  [Expand]DevExpress.Utils.Win
  [Expand]DevExpress.XtraBars
  [Expand]DevExpress.XtraBars.Alerter
  [Expand]DevExpress.XtraBars.Docking
  [Expand]DevExpress.XtraBars.Docking2010
  [Expand]DevExpress.XtraBars.Docking2010.Customization
  [Expand]DevExpress.XtraBars.Docking2010.Views
  [Expand]DevExpress.XtraBars.Docking2010.Views.NativeMdi
  [Expand]DevExpress.XtraBars.Docking2010.Views.Tabbed
  [Expand]DevExpress.XtraBars.Docking2010.Views.Widget
  [Expand]DevExpress.XtraBars.Docking2010.Views.WindowsUI
  [Expand]DevExpress.XtraBars.Localization
  [Expand]DevExpress.XtraBars.Navigation
  [Expand]DevExpress.XtraBars.Ribbon
  [Expand]DevExpress.XtraBars.Ribbon.Gallery
  [Expand]DevExpress.XtraBars.Ribbon.ViewInfo
  [Expand]DevExpress.XtraBars.ToastNotifications
  [Expand]DevExpress.XtraBars.Utils
  [Expand]DevExpress.XtraBars.WinRTLiveTiles
  [Expand]DevExpress.XtraCharts
  [Expand]DevExpress.XtraCharts.Designer
  [Expand]DevExpress.XtraCharts.Wizard
  [Expand]DevExpress.XtraDataLayout
  [Expand]DevExpress.XtraDiagram
  [Expand]DevExpress.XtraDiagram.Options
  [Expand]DevExpress.XtraEditors
  [Expand]DevExpress.XtraEditors.ButtonPanel
  [Expand]DevExpress.XtraEditors.Calendar
  [Expand]DevExpress.XtraEditors.Camera
  [Expand]DevExpress.XtraEditors.Container
  [Expand]DevExpress.XtraEditors.Controls
  [Expand]DevExpress.XtraEditors.CustomEditor
  [Expand]DevExpress.XtraEditors.DXErrorProvider
  [Expand]DevExpress.XtraEditors.Filtering
  [Expand]DevExpress.XtraEditors.Mask
  [Expand]DevExpress.XtraEditors.Persistent
  [Expand]DevExpress.XtraEditors.Repository
  [Expand]DevExpress.XtraEditors.ViewInfo
  [Expand]DevExpress.XtraFilterEditor
  [Expand]DevExpress.XtraGauges.Presets.Styles
  [Expand]DevExpress.XtraGauges.Win
  [Expand]DevExpress.XtraGauges.Win.Base
  [Expand]DevExpress.XtraGauges.Win.Gauges.Circular
  [Expand]DevExpress.XtraGauges.Win.Gauges.Digital
  [Expand]DevExpress.XtraGauges.Win.Gauges.Linear
  [Expand]DevExpress.XtraGauges.Win.Gauges.State
  [Expand]DevExpress.XtraGrid
  [Expand]DevExpress.XtraGrid.Columns
  [Expand]DevExpress.XtraGrid.EditForm
  [Expand]DevExpress.XtraGrid.FilterEditor
  [Expand]DevExpress.XtraGrid.Localization
  [Expand]DevExpress.XtraGrid.Views.BandedGrid
  [Expand]DevExpress.XtraGrid.Views.BandedGrid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Base
  [Expand]DevExpress.XtraGrid.Views.Base.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Card
  [Expand]DevExpress.XtraGrid.Views.Card.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Grid
  [Expand]DevExpress.XtraGrid.Views.Grid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Layout
  [Expand]DevExpress.XtraGrid.Views.Layout.Events
  [Expand]DevExpress.XtraGrid.Views.Layout.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Printing
  [Expand]DevExpress.XtraGrid.Views.Tile
  [Expand]DevExpress.XtraGrid.Views.WinExplorer
  [Expand]DevExpress.XtraGrid.WinExplorer
  [Expand]DevExpress.XtraLayout
  [Expand]DevExpress.XtraLayout.Customization
  [Expand]DevExpress.XtraLayout.HitInfo
  [Expand]DevExpress.XtraLayout.Localization
  [Expand]DevExpress.XtraLayout.Utils
  [Expand]DevExpress.XtraMap
  [Expand]DevExpress.XtraMap.Printing
  [Collapse]DevExpress.XtraNavBar
   [Expand]Collection Class
   [Expand]CollectionItemEventArgs Class
    CollectionItemEventHandler Delegate
   [Expand]ComponentCollectionItem Class
   [Expand]ICollectionItem Interface
    LinkSelectionModeType Enumeration
   [Expand]NavBarAppearances Class
   [Expand]NavBarCalcGroupClientHeightEventArgs Class
    NavBarCalcGroupClientHeightEventHandler Delegate
   [Expand]NavBarCalcHintSizeEventArgs Class
    NavBarCalcHintSizeEventHandler Delegate
   [Collapse]NavBarControl Class
     NavBarControl Members
     NavBarControl Constructor
    [Collapse]NavBarControl Properties
      ActiveGroup Property
      ActiveGroupName Property
      AllowDrop Property
      AllowGlyphSkinning Property
      AllowHorizontalResizing Property
      AllowHtmlString Property
      AllowSelectedLink Property
      Appearance Property
      AvailableNavBarViews Property
      BackgroundImage Property
      BackgroundImageLayout Property
      BorderStyle Property
      ContentButtonHint Property
      Cursor Property
      DragDropFlags Property
      EachGroupHasSelectedLink Property
      ExplorerBarGroupInterval Property
      ExplorerBarGroupOuterIndent Property
      ExplorerBarShowGroupButtons Property
      ExplorerBarStretchLastGroup Property
      FireDelayedSelectedLinkChangedEvent Property
      GroupBackgroundImage Property
      Groups Property
      GroupTextureBackgroundBrush Property
      HideGroupCaptions Property
      HotTrackedGroup Property
      HotTrackedGroupCursor Property
      HotTrackedItemCursor Property
      HotTrackedLink Property
      HtmlImages Property
      IsDesignMode Property
      IsLoading Property
      Items Property
      LargeImages Property
      LayoutVersion Property
      LinkInterval Property
      LinkSelectionMode Property
      LookAndFeel Property
      MenuManager Property
      MinimumSize Property
      NavigationPaneGroupClientHeight Property
      NavigationPaneMaxVisibleGroups Property
      NavigationPaneOverflowPanelUseSmallImages Property
      NavPaneForm Property
      OptionsLayout Property
      OptionsNavPane Property
      PaintAppearance Property
      PaintStyleKind Property
      PaintStyleName Property
      PressedGroup Property
      PressedLink Property
      ScaleImages Property
      ScrollMode Property
      SelectedLink Property
      SelectLinkOnPress Property
      SharedImageCollectionImageSizeMode Property
      ShowGroupHint Property
      ShowHintInterval Property
      ShowIcons Property
      ShowLinkHint Property
      SkinExplorerBarViewScrollStyle Property
      SmallImages Property
      State Property
      StoreDefaultPaintStyleName Property
      SuspendFormLayoutInAnimation Property
      TabStop Property
      ToolTipController Property
      View Property
      ViewName Property
    [Expand]NavBarControl Events
    [Expand]NavBarControl Methods
   [Expand]NavBarCustomDrawHintEventArgs Class
    NavBarCustomDrawHintEventHandler Delegate
   [Expand]NavBarCustomHintEventArgs Class
    NavBarDragDrop Enumeration
   [Expand]NavBarGetHintEventArgs Class
    NavBarGetHintEventHandler Delegate
   [Expand]NavBarGroup Class
   [Expand]NavBarGroupControlContainer Class
   [Expand]NavBarGroupEventArgs Class
    NavBarGroupEventHandler Delegate
    NavBarGroupStyle Enumeration
   [Expand]NavBarHitInfo Class
    NavBarHitTest Enumeration
    NavBarImage Enumeration
   [Expand]NavBarItem Class
   [Expand]NavBarItemLink Class
   [Expand]NavBarLayoutOptions Class
   [Expand]NavBarLinkEventArgs Class
    NavBarLinkEventHandler Delegate
    NavBarState Enumeration
    NavBarStringId Enumeration
    NavBarViewKind Enumeration
   [Expand]NavElement Class
   [Expand]NavGroupCollection Class
   [Expand]NavItemCollection Class
   [Expand]NavLinkCollection Class
    NavPaneState Enumeration
   [Expand]NavReadOnlyLinkCollection Class
   [Expand]OptionsNavPane Class
    SkinExplorerBarViewScrollStyle Enumeration
  [Expand]DevExpress.XtraNavBar.ViewInfo
  [Expand]DevExpress.XtraPdfViewer
  [Expand]DevExpress.XtraPdfViewer.Commands
  [Expand]DevExpress.XtraPdfViewer.Localization
  [Expand]DevExpress.XtraPivotGrid
  [Expand]DevExpress.XtraPivotGrid.Data
  [Expand]DevExpress.XtraPrinting
  [Expand]DevExpress.XtraPrinting.Control
  [Expand]DevExpress.XtraPrinting.Preview
  [Expand]DevExpress.XtraPrintingLinks
  [Expand]DevExpress.XtraReports.UI
  [Expand]DevExpress.XtraRichEdit
  [Expand]DevExpress.XtraRichEdit.Commands
  [Expand]DevExpress.XtraRichEdit.Export
  [Expand]DevExpress.XtraRichEdit.Import
  [Expand]DevExpress.XtraRichEdit.Localization
  [Expand]DevExpress.XtraRichEdit.Menu
  [Expand]DevExpress.XtraScheduler
  [Expand]DevExpress.XtraScheduler.Drawing
  [Expand]DevExpress.XtraScheduler.Printing
  [Expand]DevExpress.XtraScheduler.Reporting
  [Expand]DevExpress.XtraScheduler.Reporting.UI
  [Expand]DevExpress.XtraScheduler.Services
  [Expand]DevExpress.XtraScheduler.Services.Implementation
  [Expand]DevExpress.XtraScheduler.UI
  [Expand]DevExpress.XtraSpellChecker
  [Expand]DevExpress.XtraSpellChecker.Localization
  [Expand]DevExpress.XtraSplashForm
  [Expand]DevExpress.XtraSplashScreen
  [Expand]DevExpress.XtraSpreadsheet
  [Expand]DevExpress.XtraSpreadsheet.Services
  [Expand]DevExpress.XtraTab
  [Expand]DevExpress.XtraTab.Buttons
  [Expand]DevExpress.XtraTab.ViewInfo
  [Expand]DevExpress.XtraTabbedMdi
  [Expand]DevExpress.XtraToolbox
  [Expand]DevExpress.XtraTreeList
  [Expand]DevExpress.XtraTreeList.Columns
  [Expand]DevExpress.XtraTreeList.Data
  [Expand]DevExpress.XtraTreeList.Localization
  [Expand]DevExpress.XtraTreeList.Menu
  [Expand]DevExpress.XtraTreeList.Nodes
  [Expand]DevExpress.XtraTreeList.Nodes.Operations
  [Expand]DevExpress.XtraTreeList.StyleFormatConditions
  [Expand]DevExpress.XtraTreeMap
  [Expand]DevExpress.XtraVerticalGrid
  [Expand]DevExpress.XtraVerticalGrid.Events
  [Expand]DevExpress.XtraVerticalGrid.Localization
  [Expand]DevExpress.XtraVerticalGrid.Rows
  [Expand]DevExpress.XtraWaitForm
  [Expand]DevExpress.XtraWizard
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

NavBarControl.LinkSelectionMode Property

Gets or sets whether link selection is enabled and whether each group or only one group can contain a selected link simultaneously.

Namespace:DevExpress.XtraNavBar
Assembly:DevExpress.XtraNavBar.v17.1.dll

Expanded Syntax

Property value

Type: LinkSelectionModeType
The LinkSelectionModeType value that specifies the link selection mode.
The default is LinkSelectionModeType.None.

Expanded Remarks

The LinkSelectionMode property allows you to enable link selection and to specify the mode in which links can be selected. By default, link selection is disabled. A click on a link fires the LinkClicked and NavBarItem.LinkClicked events which you can handle to perform custom actions. You cannot differentiate a clicked link from non-clicked links.

Link selection (link highlighting clicked once) To enable link selection, set the LinkSelectionMode property to one of the following modes:

Link Selection Mode Description
LinkSelectionModeType.OneInControl Only one link at a time can be selected throughout the NavBarControl.
LinkSelectionModeType.OneInGroup Each group has a selected link independent of other groups. A group will not have a selected link until you or an end-user has selected a link.
LinkSelectionModeType.OneInGroupAndAllowAutoSelect Each group also has a selected link independent of other groups. Unlike the previous mode, the OneInGroupAndAllowAutoSelect mode enables automatic link selection in a group if the group does not already have a selection. By default, the first link in the group is auto-selected. To prevent a specific link from being auto-selected, use the NavBarItem.AllowAutoSelect and NavBarItemLink.AllowAutoSelect properties.
Note

Automatic link selection is not supported for Explorer Bar Views.

To respond to link selection, handle the SelectedLinkChanged event, rather than the previously mentioned click events. The SelectedLink, NavBarGroup.SelectedLink and NavBarGroup.SelectedLinkIndex properties allow you to specify the selected link for the NavBarControl and for each group.

Expanded See Also

How would you rate this topic?​​​​​​​