Tab

ASPxVerticalGrid.CustomButtonInitialize Event

Enables you to initialize a custom command button.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v20.1.dll

Declaration

public event ASPxVerticalGridCustomButtonEventHandler CustomButtonInitialize
Public Event CustomButtonInitialize As ASPxVerticalGridCustomButtonEventHandler

Event Data

The CustomButtonInitialize event's data class is ASPxVerticalGridCustomCommandButtonEventArgs. The following properties provide information specific to this event:

Property Description
ButtonID Gets the processed custom button's identifier. Inherited from ASPxGridCustomCommandButtonEventArgs.
Enabled Gets or sets a value that specifies whether the processed custom button is enabled. Inherited from ASPxGridCustomCommandButtonEventArgs.
Image Gets the settings of an image displayed within the processed custom button. Inherited from ASPxGridCustomCommandButtonEventArgs.
RenderMode Specifies the processed custom command button's render mode. Inherited from ASPxGridCustomCommandButtonEventArgs.
Row Gets a command row which owns the processed custom command button.
Styles Gets the processed custom button's style. Inherited from ASPxGridCustomCommandButtonEventArgs.
Text Gets or sets the processed custom button's text. Inherited from ASPxGridCustomCommandButtonEventArgs.
Visible Gets or sets whether the processed custom button is visible. Inherited from ASPxGridCustomCommandButtonEventArgs.
VisibleIndex Gets the visible index of a data item (row, card or record) which contains the processed custom button. Inherited from ASPxGridCustomCommandButtonEventArgs.

Remarks

The CustomButtonInitialize event is raised for each custom command button, and enables you to initialize it. For instance, you can handle this event to hide individual buttons.

The event parameter's properties allow you to identify the button, record, the type of a cell which contains the processed button, etc.

To initialize individual built-in command buttons (edit, new, delete, etc.), handle the ASPxVerticalGrid.CommandButtonInitialize event.

NOTE

If you call the GetRecordValues method in the CustomButtonInitialize event handler, you should take into account the specific behavior described in the ASPxVerticalGrid.GetRecordValues topic.

NOTE

It is impossible to change the style of the selection checkbox using the CustomButtonInitialize event.

See Also