Back to Devexpress

NavigatorButtonBase.Enabled Property

windowsforms-devexpress-dot-xtraeditors-dot-navigatorbuttonbase.md

latest3.6 KB
Original Source

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.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
[DefaultValue(true)]
[DXCategory("Behavior")]
public bool Enabled { get; set; }
vb
<DefaultValue(True)>
<DXCategory("Behavior")>
Public Property Enabled As Boolean

Property Value

TypeDefaultDescription
Booleantrue

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.

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.

how-to-use-richeditcontrol-in-bound-mode/CS/Form1.cs#L56

csharp
// 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

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

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

vb
' 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

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

See Also

NavigatorButtonBase Class

NavigatorButtonBase Members

DevExpress.XtraEditors Namespace