The requested page is not available for the requested platform. You are viewing the content for Default platform.

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 handler receives an argument of the ASPxClientRibbonDialogBoxLauncherClickedEventArgs type. 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 Gets or sets a value that specifies whether the event should be finally processed on the server side.

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.

See Also