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.