Skip to main content

TreeListView.ShowUpdateRowButtons Property

Gets or sets a mode that specifies how to show the buttons which allow you to update rows.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v24.2.dll

NuGet Package: DevExpress.Wpf.Grid.Core

Declaration

public ShowUpdateRowButtons ShowUpdateRowButtons { get; set; }

Property Value

Type Description
ShowUpdateRowButtons

A mode that specifies how to show the buttons which allow you to update rows.

Available values:

Name Description
Never

The buttons are not shown.

OnCellEditorOpen

The buttons are shown after you open a cell editor.

OnCellValueChange

The buttons are shown after you change a cell value.

Remarks

The GridControl provides an edit mode that allows you to edit an entire row and only then post changes to the datasource. In this mode, the GridControl shows the Update and Cancel buttons for the row that is being edited. You should change the row’s cell values and then click Update to post chages:

You cannot navigate away from an edited row unless you click the Update / Cancel button or press Esc twice.

Run Demo: Edit Entire Row

To enable the Edit Entire Row mode, specify the ShowUpdateRowButtons property:

  • When the property value is OnCellEditorOpen, the buttons are shown after you open a cell editor:

  • When the property value is OnCellValueChange, the buttons are shown after you change a cell value:

Click the Update button to post the edited row’s changes to the datasource. Alternatively, you can call the TableView.UpdateRow / TreeListView.UpdateRow method or the TableViewCommands.UpdateRow / TreeListViewCommands.UpdateRow command.

Click the Cancel button to discard the edited row’s changes. Alternatively, you can call the TableView.CancelRowChanges / TreeListView.CancelRowChanges method or the TableViewCommands.CancelRowChanges / TreeListViewCommands.CancelRowChanges command.

Use the TableView.UpdateRowButtonsTemplate / TreeListView.UpdateRowButtonsTemplate property to change the appearance of the Update and Cancel buttons.

Limitations

  • The Edit Entire Row mode is available in optimized mode only.
  • The Edit Entire Row mode is incompatible with the Edit Form.
See Also