GridColumn.ShowButtonMode Property

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

Namespace: DevExpress.XtraGrid.Columns

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

C#

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

VB.NET

<DefaultValue(ShowButtonModeEnum.Default)>
<XtraSerializableProperty>
<DXCategory("Appearance")>
Public Property ShowButtonMode As ShowButtonModeEnum

Property Value

Type	Default	Description
ShowButtonModeEnum	**Default**	A ShowButtonModeEnum enumeration value specifying which column cells display editor buttons.

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.

Remarks

You can specify which cells display in-place editor buttons using the View’s ColumnViewOptionsView.ShowButtonMode property. The column’s ShowButtonMode property allows you to override this behavior for individual columns. By default, the GridColumn.ShowButtonMode property value is ShowButtonModeEnum.Default which means that the column uses the View’s ColumnViewOptionsView.ShowButtonMode setting.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ShowButtonMode 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.

C#

buttonedit-how-to-use-different-images-for-buttons-in-different-states-t538328/CS/ButtonEditImages/Main.cs#L34

    column.ColumnEdit = item;
    column.ShowButtonMode = DevExpress.XtraGrid.Views.Base.ShowButtonModeEnum.ShowAlways;
}

VB.NET

buttonedit-how-to-use-different-images-for-buttons-in-different-states-t538328/VB/ButtonEditImages/Main.vb#L33

    column.ColumnEdit = item
    column.ShowButtonMode = DevExpress.XtraGrid.Views.Base.ShowButtonModeEnum.ShowAlways
End Sub