NavigatorButtonBase.Enabled Property

Gets or sets whether the button is enabled and an end-user can perform actions on it.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(true)]
[DXCategory("Behavior")]
public bool Enabled { get; set; }

VB.NET

<DefaultValue(True)>
<DXCategory("Behavior")>
Public Property Enabled As Boolean

Property Value

Type	Default	Description
Boolean	true	true if the button is enabled and an end-user can perform actions on it; otherwise, false.

Remarks

Set the Enabled property to false to temporarily disable it. The disabled button is displayed grayed and does not react to mouse events. For example, disable the Append, Remove, EndEdit and CancelEdit buttons to prohibit an end-user from changing data within a data source.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Enabled 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-use-richeditcontrol-in-bound-mode/CS/Form1.cs#L56

// Update control level commands state
dataNavigator1.Buttons.CancelEdit.Enabled = richEditControl1.Modified;
dataNavigator1.Buttons.EndEdit.Enabled = richEditControl1.Modified;

winforms-grid-sql-pagination/CS/DxSample/MainForm.cs#L60

offset = Math.Max(0, offset);
OrdersGrid.EmbeddedNavigator.Buttons.CustomButtons[0].Enabled = offset > 0;
DataAdapter.SelectCommand.Parameters["@offset"].Value = offset;

VB.NET

how-to-use-richeditcontrol-in-bound-mode/VB/Form1.vb#L51

' Update control level commands state
dataNavigator1.Buttons.CancelEdit.Enabled = richEditControl1.Modified
dataNavigator1.Buttons.EndEdit.Enabled = richEditControl1.Modified

winforms-grid-sql-pagination/VB/DxSample/MainForm.vb#L66

offset = Math.Max(0, offset)
OrdersGrid.EmbeddedNavigator.Buttons.CustomButtons(0).Enabled = offset > 0
DataAdapter.SelectCommand.Parameters("@offset").Value = offset