Back to Devexpress

ColumnViewOptionsView.ShowButtonMode Property

windowsforms-devexpress-dot-xtragrid-dot-views-dot-base-dot-columnviewoptionsview-1c633bdf.md

latest4.2 KB
Original Source

ColumnViewOptionsView.ShowButtonMode Property

Gets or sets a value that specifies which column cells display editor buttons.

Namespace : DevExpress.XtraGrid.Views.Base

Assembly : DevExpress.XtraGrid.v25.2.dll

NuGet Packages : DevExpress.Win.Grid, DevExpress.Win.Navigation

Declaration

csharp
[DefaultValue(ShowButtonModeEnum.Default)]
[DXCategory("Appearance")]
[XtraSerializableProperty]
public ShowButtonModeEnum ShowButtonMode { get; set; }
vb
<DefaultValue(ShowButtonModeEnum.Default)>
<XtraSerializableProperty>
<DXCategory("Appearance")>
Public Property ShowButtonMode As ShowButtonModeEnum

Property Value

TypeDefaultDescription
ShowButtonModeEnumDefault

A value that specifies which column cells display editor buttons.

|

Available values:

NameDescription
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 TypePath to ShowButtonMode
ColumnView

.OptionsView .ShowButtonMode

|

Remarks

Use the GridColumn.ShowButtonMode property to override the OptionsView.ShowButtonMode setting for individual columns.

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.

See Also

ColumnEdit

CustomRowCellEdit

ShowButtonMode

TextEditStyle

ColumnViewOptionsView Class

ColumnViewOptionsView Members

DevExpress.XtraGrid.Views.Base Namespace