NavBarControl.SelectedLink Property

Gets or sets an object representing the selected link.

Namespace: DevExpress.XtraNavBar

Assembly: DevExpress.XtraNavBar.v19.1.dll

Declaration

C#

[Browsable(false)]
public virtual NavBarItemLink SelectedLink { get; set; }

VB.NET

<Browsable(False)>
Public Overridable Property SelectedLink As NavBarItemLink

Property Value

Type	Description
NavBarItemLink	A NavBarItemLink object representing the selected link.

Remarks

End-users can select links via mouse clicks. The NavBarControl also provides the capability to select links in code. You can use the SelectedLink property for this purpose.

In the Navigation Pane and Side Bar Views, the SelectedLink property specifies the selected link in the active group (NavBarControl.ActiveGroup). In the Explorer Bar Views, which provide access to all groups simultaneously, the SelectedLink property specifies the first group’s selected link. To refer to the selected link in a specific group, use the NavBarGroup.SelectedLink or NavBarGroup.SelectedLinkIndex property instead. If link selection is prohibited, the SelectedLink property returns null and assigning the SelectedLink property has no effect.

See the NavBarControl.LinkSelectionMode topic for details on enabling link selection.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the SelectedLink 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-create-a-navbarcontrol-descendant-that-will-implement-keyboard-navigation-e893/CS/WindowsApplication1/Form1.cs#L381

private void timer1_Tick(object sender, System.EventArgs e) {
    if (navBarControl1.SelectedLink != null) {
        Text = String.Format("{0} {1}", navBarControl1.SelectedLink, navBarControl1.SelectedLink.ItemName);

how-to-add-the-navbarcontrol-to-the-wizardcontrol-e972/CS/Q138607/MyWizardControl.cs#L79

if (SelectedPageIndex < 0 || SelectedPageIndex >= navBarGroup1.ItemLinks.Count) return;
navBarControl1.SelectedLink = navBarGroup1.ItemLinks[SelectedPageIndex];
for (int i = 0; i < navBarGroup1.ItemLinks.Count; i++)

VB.NET

how-to-create-a-navbarcontrol-descendant-that-will-implement-keyboard-navigation-e893/VB/WindowsApplication1/Form1.vb#L316

Private Sub timer1_Tick(ByVal sender As Object, ByVal e As System.EventArgs) Handles timer1.Tick
    If navBarControl1.SelectedLink IsNot Nothing Then
        Text = String.Format("{0} {1}", navBarControl1.SelectedLink, navBarControl1.SelectedLink.ItemName)

how-to-add-the-navbarcontrol-to-the-wizardcontrol-e972/VB/Q138607/MyWizardControl.vb#L88

End If
navBarControl1.SelectedLink = navBarGroup1.ItemLinks(SelectedPageIndex)
For i As Integer = 0 To navBarGroup1.ItemLinks.Count - 1