BarItemLink.Focus() Method

Moves focus to the link.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v19.2.dll

Declaration

C#

public virtual void Focus()

VB.NET

Public Overridable Sub Focus

Remarks

Use the Focus method to move focus to the link. Such a link is highlighted according to the current paint scheme.

You are not able to move focus to a link currently hidden, for example, in the popup menu. To open a menu for a container item, you can call the BarCustomContainerItemLink.OpenMenu method. To open the popup menu, call PopupMenu.ShowPopup.

Example

The following example shows how you can focus a specific subitem within a container item.

The menu for the mFile item of the BarSubItem class is activated. To do this, the BarCustomContainerItemLink.OpenMenu method is called.

After the menu is opened, we focus the first subitem in it using the BarItemLink.Focus method.

The result is shown below:

C#

// The item and its link for which the menu should be opened
BarSubItem containerItem = mFile;
BarSubItemLink containerLink = containerItem.Links[0] as BarSubItemLink;
// Open the menu for the link
containerLink.OpenMenu();
// Focus the first link in the menu opened
containerLink.VisibleLinks[0].Focus();            

VB.NET

' The item and its link for which the menu should be opened
Dim containerItem As BarSubItem = mFile
Dim containerLink As BarSubItemLink = CType(containerItem.Links[0], BarSubItemLink)
' Open the menu for the link
containerLink.OpenMenu()
' Focus the first link in the menu opened
containerLink.VisibleLinks[0].Focus()

Related GitHub Examples

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

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-activate-a-specific-editor-located-in-a-bar-or-ribbon-e3793/CS/WindowsApplication1/RibbonForm1.cs#L21

{
    barEditItem1.Links[0].Focus();
    (barEditItem1.Links[0] as BarEditItemLink).ShowEditor();

links-searching-functionality-in-the-popupmenu-applicationmenu-dropdown-e4364/CS/WindowsFormsApplication1/PopupMenuSearchHelper.cs#L71

(sender as PopupMenu).Manager.Form.BeginInvoke(new MethodInvoker(delegate{
    (sender as PopupMenu).ItemLinks[0].Focus();
}));

VB.NET

how-to-activate-a-specific-editor-located-in-a-bar-or-ribbon-e3793/VB/WindowsApplication1/RibbonForm1.vb#L19

Private Sub barButtonItem1_ItemClick(ByVal sender As Object, ByVal e As ItemClickEventArgs) Handles barButtonItem1.ItemClick
    barEditItem1.Links(0).Focus()
    TryCast(barEditItem1.Links(0), BarEditItemLink).ShowEditor()

links-searching-functionality-in-the-popupmenu-applicationmenu-dropdown-e4364/VB/WindowsFormsApplication1/PopupMenuSearchHelper.vb#L68

Private Sub FocusSearchItem()
    currentMenu.ItemLinks(0).Focus()
End Sub