RepositoryItemButtonEdit.AllowButtonNavigation Property

Gets or sets whether to allow users to focus ButtonEdit buttons with the keyboard.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v24.2.dll

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Behavior")]
public virtual DefaultBoolean AllowButtonNavigation { get; set; }

VB.NET

<DefaultValue(DefaultBoolean.Default)>
<DXCategory("Behavior")>
Public Overridable Property AllowButtonNavigation As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	true to allow users to focus ButtonEdit buttons with the keyboard; otherwise, false.

Available values:

Name	Description	Return Value
True	The value is true.	0
False	The value is false.	1
Default	The value is specified by a global option or a higher-level object.	2

Remarks

The Default value depends on the WindowsFormsSettings.KeyboardNavigationExtensions property value.

Enable the AllowButtonNavigation option to allow users to perform the following actions:

• Press the Tab key to focus the first editor button.
• Use Left and Right Arrows to navigate between buttons and the Space/Enter key to execute the button action.
• Press Shift+Tab or Esc to move the focus back to the text field.

If you set the RepositoryItemButtonEdit.TextEditStyle property to HideTextEditor and AllowButtonNavigation to true, the ButtonEdit focuses its first button once the editor gets focus.