ASPxClientRibbon.DialogBoxLauncherClicked Event

Fires on the client side after a dialog box launcher has been clicked.

Declaration

DialogBoxLauncherClicked: ASPxClientEvent<ASPxClientRibbonDialogBoxLauncherClickedEventHandler<ASPxClientRibbon>>

Event Data

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

Property	Description
group	Gets the client group object to which the clicked dialog box launcher belongs.
processOnServer	Specifies whether or not to process the event on the server. Inherited from ASPxClientProcessingModeEventArgs.

Remarks

Write a DialogBoxLauncherClicked event handler to perform specific actions on the client side after a dialog box launcher is clicked. You can use the event argument’s ASPxClientRibbonDialogBoxLauncherClickedEventArgs.group property to identify whose dialog box launcher is clicked.

If the processOnServer property is set to false (default value), the DialogBoxLauncherClicked event is completely handled on the client side using the assigned JScript handler without a postback to the server. Setting the DialogBoxLauncherClicked property to true indicates that the final processing of the event should be performed on the server side and so a round trip to the server is required. During such a round trip, the corresponding server-side ASPxRibbon.DialogBoxLauncherClicked event fires which when handled, allows any desired server-side action to be performed.