GridControl.EmbeddedNavigator Property
Provides access to the embedded data navigator.
Namespace: DevExpress.XtraGrid
Assembly: DevExpress.XtraGrid.v19.2.dll
Declaration
Property Value
Type | Description |
---|---|
ControlNavigator | A ControlNavigator descendant representing the grid control’s embedded data navigator. |
Remarks
When the GridControl.UseEmbeddedNavigator property value is true, the grid control displays a data navigator at the bottom. The EmbeddedNavigator property provides access to this navigator’s settings. Using this property, you can control a buttons’ visibility, change its appearance and hint texts, etc.
You can also enable/disable the navigator’s Append and Delete buttons via the ColumnViewOptionsBehavior.AllowAddRows and ColumnViewOptionsBehavior.AllowDeleteRows options.
The enabled state of specific buttons (e.g., EndEdit and CancelEdit) is controlled automatically and cannot be changed using the button’s Enabled property. For instance, the EndEdit button, which is used to post the edited value, is automatically activated when an end user activates an editor in the grid, and is deactivated when the cell editor closes.
Note that you can also link an external ControlNavigator to the grid control. Just place a ControlNavigator control onto the form and bind it to your grid using its ControlNavigator.NavigatableControl property.
Please refer to the Using Navigators topic, for additional information.
Example
In this example we change the visibility of two buttons of the embedded navigator: Append and Remove.
ControlNavigator navigator = gridControl1.EmbeddedNavigator;
navigator.Buttons.BeginUpdate();
try {
navigator.Buttons.Append.Visible = false;
navigator.Buttons.Remove.Visible = false;
}
finally {
navigator.Buttons.EndUpdate();
}
Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the EmbeddedNavigator 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.