A newer version of this page is available. Switch to the current version.

ColumnViewOptionsView.ShowButtonMode Property

Gets or sets the display mode for in-place editor buttons.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

[DefaultValue(ShowButtonModeEnum.Default)]
[XtraSerializableProperty]
[DXCategory("Appearance")]
public ShowButtonModeEnum ShowButtonMode { get; set; }

Property Value

Type Default Description
ShowButtonModeEnum

Default

The ShowButtonModeEnum value that specifies the mode in which the editor buttons are displayed in a View.

Available values:

Name Description
Default

If a column’s GridColumn.ShowButtonMode property is set to this value, the column uses the View’s settings. Assigning this value to the View’s ColumnViewOptionsView.ShowButtonMode property is equivalent to assigning the ShowForFocusedCell value.

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.

Property Paths

You can access this nested property as listed below:

Object Type Path to ShowButtonMode
AdvBandedGridView
.OptionsView.ShowButtonMode
BandedGridView
.OptionsView.ShowButtonMode
ColumnView
.OptionsView.ShowButtonMode
CardView
.OptionsView.ShowButtonMode
GridView
.OptionsView.ShowButtonMode
LayoutView
.OptionsView.ShowButtonMode
TileView
.OptionsView.ShowButtonMode
WinExplorerView
.OptionsView.ShowButtonMode

Remarks

By default, in-place editor buttons are shown for the focused cell only. Use the ShowButtonMode property to change this behavior.

Individual columns can override the ShowButtonMode setting with their GridColumn.ShowButtonMode properties.

Regardless of the OptionsView.ShowButtonMode and GridColumn.ShowButtonMode settings, editor buttons are simultaneously shown in all cells that contain in-place editors with the RepositoryItemButtonEdit.TextEditStyle setting set to HideTextEdit. To show these editor buttons only in the focused row or focused cell, supply editors to grid cells dynamically, with the GridView.CustomRowCellEdit event.

See Also