GridColumn.ShowButtonMode Property
Gets or sets a value that specifies which column cells display editor buttons.
Namespace: DevExpress.XtraGrid.Columns
Assembly: DevExpress.XtraGrid.v23.2.dll
NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation
Declaration
[DefaultValue(ShowButtonModeEnum.Default)]
[DXCategory("Appearance")]
[XtraSerializableProperty]
public ShowButtonModeEnum ShowButtonMode { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| ShowButtonModeEnum | Default | A value that specifies which column cells display editor buttons. |
Available values:
| Name | Description |
|---|---|
| Default | If a column’s |
| ShowAlways | Editor buttons are displayed for all cells within the column/view. |
| ShowForFocusedRow | Buttons are displayed for cells that reside within the focused row. |
| ShowForFocusedCell | Editor buttons are displayed for the focused cell only. |
| ShowOnlyInEditor | Buttons are displayed only when a cell editor is active. |
Remarks
Use a View’s OptionsView.ShowButtonMode property to specify which cells display in-place editor buttons. The column’s GridColumn.ShowButtonMode property allows you to override this setting for individual columns.
The GridColumn.ShowButtonMode property’s default value is ShowButtonModeEnum.Default, which means that the column uses the View’s ColumnViewOptionsView.ShowButtonMode setting.
The OptionsView.ShowButtonMode and GridColumn.ShowButtonMode properties are only in effect for column editors that have the GridColumn.ColumnEdit.TextEditStyle option set to Standard.
Note
A column does not display edit buttons within its cells regardless of the view’s OptionsView.ShowButtonMode setting if the view’s Editable option or the column’s OptionsColumn.AllowEdit option is set to false.
A column always displays edit buttons within its cells if its GridColumn.ShowButtonMode property is set to true even if the view’s Editable option or the column’s OptionsColumn.AllowEdit option is disabled.