Command Rows

  • 2 minutes to read

End-users manipulate ASPxVerticalGrid data using command rows. ASPxVerticalGrid stores command rows together with its rows within the ASPxVerticalGrid.Rows collection.

Commands

A command row is the VerticalGridCommandRow class. It provides a set of commands that allow end-users to switch ASPxVerticalGrid to batch edit mode, as well as update data, delete records, etc.

A command row allows multiple command items to be displayed within a cell. A single command is displayed as a command item. There are several command items.

Command Description Property
New Creates a new record. ASPxVerticalGridCommandButtonSettings.NewButton
Edit Switches ASPxVerticalGrid to batch edit mode. ASPxVerticalGridCommandButtonSettings.EditButton
Delete Deletes the current record. ASPxVerticalGridCommandButtonSettings.DeleteButton
Select Selects/deselects records. ASPxVerticalGridCommandButtonSettings.SelectButton, VerticalGridCommandRow.ShowSelectCheckbox
Save changes Saves all the changes made to the current record and switches ASPxVerticalGrid to a browse mode. ASPxVerticalGridCommandButtonSettings.UpdateButton
Cancel Discards any changes made to the current record and switches ASPxVerticalGrid to a browse mode. ASPxVerticalGridCommandButtonSettings.CancelButton
Recover Recovers a deleted record. ASPxVerticalGridCommandButtonSettings.RecoverButton

By default, command items are represented by a link. They can also be represented by a button or image. Use the VerticalGridCommandRow.ButtonRenderMode property to specify how the command row renders its command items.

To initialize individual command buttons, handle the ASPxVerticalGrid.CommandButtonInitialize event.

Custom Buttons

Command rows can also display custom buttons within command cells. You can create your own buttons, and define custom actions for them.

To initialize individual custom command buttons, handle the ASPxVerticalGrid.CustomButtonInitialize event.