DialogController Class
Represents a WindowController descendant that contains Actions for pop-up Windows.
Namespace: DevExpress.ExpressApp.SystemModule
Assembly: DevExpress.ExpressApp.v24.1.dll
NuGet Package: DevExpress.ExpressApp
Declaration
Remarks
The DialogController class is a descendant of the WindowController class. It is intended to present the Accept and Cancel buttons in pop-up Windows. You can inherit from this Controller to modify its behavior.
The Dialog Controller has a peculiarity. It is not added to a Frame’s Frame.Controllers collection automatically. You should add it yourself.
Basically, the Dialog Controller is required in pop-up Windows only. There are two approaches to add a Dialog Controller to a pop-up Window:
Use the PopupWindowShowAction
The DialogController class instance is, by default, contained in the pop-up Window invoked from a PopupWindowShowAction. Use the CustomizePopupWindowParamsEventArgs.DialogController parameter of your PopupWindowShowAction’s PopupWindowShowAction.CustomizePopupWindowParams event handler, to access the Dialog Controller set by default, or to replace it with a custom one.
-
Add a Dialog Controller in a pop-up Window via the ActionBaseEventArgs.ShowViewParameters parameter of your Action’sExecute event handler.
For details, refer to the Dialog Controller topic.
Use the DialogController.AcceptAction and DialogController.CancelAction properties to access the Dialog Controller’s Accept and Cancel Actions. To change their behavior, use the DialogController.SaveOnAccept and DialogController.CanCloseWindow properties, and handle the DialogController.Accepting and DialogController.Cancelling events.
Information on the DialogController and its Actions is available in the Application Model. To access it, use the Model Editor.