GridControl.EmbeddedNavigator Property

Provides access to the embedded data navigator.

Namespace: DevExpress.XtraGrid

Assembly: DevExpress.XtraGrid.v20.1.dll

Declaration

[DXCategory("Appearance")]
public virtual ControlNavigator EmbeddedNavigator { get; }
<DXCategory("Appearance")>
Public Overridable ReadOnly Property EmbeddedNavigator As ControlNavigator

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.

Examples

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();
    }
See Also