ASPxGridView.CustomButtonCallback Event

Occurs when a custom command button has been clicked.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v18.2.dll

Declaration

C#

public event ASPxGridViewCustomButtonCallbackEventHandler CustomButtonCallback

VB.NET

Public Event CustomButtonCallback As ASPxGridViewCustomButtonCallbackEventHandler

Event Data

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

Property	Description
ButtonID	Gets a value that identifies the clicked custom button. Inherited from ASPxGridCustomButtonCallbackEventArgs.
VisibleIndex	Gets the index of a data item (row, card or record) that contains the custom button currently being clicked. Inherited from ASPxGridCustomButtonCallbackEventArgs.

Remarks

Handle the CustomButtonCallback event to define an action for a custom button.

The event parameter’s ASPxGridCustomButtonCallbackEventArgs.ButtonID property allows you to identify a button currently being clicked.

Example

This example shows how to create and customize a custom command button.

To create and customize a custom button at design-time, invoke the editor used to manage the GridViewCommandColumn.CustomButtons collection:

You should specify the button’s identifier, text and in which rows the custom button is displayed. In this example, the ‘Apply Default Filter’ button is created and displayed within the auto filter row.

To define an action, handle the ASPxGridView.CustomButtonCallback event.

C#

using DevExpress.Web.ASPxGridView;

protected void ASPxGridView1_CustomButtonCallback
(object sender, ASPxGridViewCustomButtonCallbackEventArgs e) {
    if (e.ButtonID != "cbFilter") return;
    ASPxGridView grid = sender as ASPxGridView;
    grid.FilterExpression = "[Title] like '%Sales%'";
}

VB.NET

Protected Sub ASPxGridView1_CustomButtonCallback(ByVal sender As Object, ByVal e As ASPxGridViewCustomButtonCallbackEventArgs)
    If e.ButtonID <> "cbFilter" Then Return
    Dim grid As ASPxGridView = TryCast(sender, ASPxGridView)
    grid.FilterExpression = "[Title] like '%Sales%'"
End Sub