ShowViewStrategyBase.ShowViewInPopupWindow(View, Action, Action, String, String) Method

Shows the specified View in a popup dialog with OK and Cancel buttons in WinForms and ASP.NET applications.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v19.2.dll

Declaration

C#

public void ShowViewInPopupWindow(
    View view,
    Action okDelegate = null,
    Action cancelDelegate = null,
    string okButtonCaption = null,
    string cancelButtonCaption = null
)

VB.NET

Public Sub ShowViewInPopupWindow(
    view As View,
    okDelegate As Action = Nothing,
    cancelDelegate As Action = Nothing,
    okButtonCaption As String = Nothing,
    cancelButtonCaption As String = Nothing
)

Parameters

Name	Type	Description
view	View	A View to be shown in a popup.

Optional Parameters

Name	Type	Default	Description
okDelegate	Action	*null*	A Action delegate to be executed when the OK button is clicked. This parameter is optional.
cancelDelegate	Action	*null*	A Action delegate to be executed when the Cancel button is clicked. This parameter is optional.
okButtonCaption	String	*null*	A string specifying the custom caption of the OK button. This parameter is optional.
cancelButtonCaption	String	*null*	A string specifying the custom caption of the Cancel button. This parameter is optional.

Remarks

Example

The ShowViewInPopupWindow method displays the dialog containing the specified View and two buttons - OK and Cancel. Both these buttons close the dialog. Additionally, if the okDelegate and cancelDelegate handlers are specified, they are executed when the corresponding button is clicked.

C#

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Actions;
using DevExpress.ExpressApp.DC;

// ...
public class MyDialogController : ViewController {
    public MyDialogController() {
        var action = new SimpleAction(this, "Email", "View");
        action.Execute += Action_Execute;
    }
    private void Action_Execute(object sender, SimpleActionExecuteEventArgs e) {
        var objectSpace = Application.CreateObjectSpace(typeof(MyDialog));
        var myDialogObject = new MyDialog("Do you want to send an email?");
        var dialogView = Application.CreateDetailView(objectSpace, myDialogObject);
        Application.ShowViewStrategy.ShowViewInPopupWindow(dialogView,
            () => {
                Application.ShowViewStrategy.ShowMessage("You've got mail.");
            },
            () => {
                Application.ShowViewStrategy.ShowMessage("Nothing happened.");
            }
        );
    }
}

[DomainComponent]
public class MyDialog {
    public MyDialog(string message) {
        this.Message = message;
    }
    public string Message { get; private set; }
}

VB.NET

Imports DevExpress.ExpressApp
Imports DevExpress.ExpressApp.Actions
Imports DevExpress.ExpressApp.DC

Public Class MyDialogController
    Inherits ViewController

    Public Sub New()
        Dim action As SimpleAction = New SimpleAction(Me, "Email", "View")
        AddHandler action.Execute, AddressOf Action_Execute
    End Sub
    Private Sub Action_Execute(ByVal sender As Object, ByVal e As SimpleActionExecuteEventArgs)
        Dim objectSpace As IObjectSpace = Application.CreateObjectSpace(GetType(MyDialog))
        Dim myDialogObject As MyDialog = New MyDialog("Do you want to send an email?")
        Dim dialogView As DetailView = Application.CreateDetailView(objectSpace, myDialogObject)
        Application.ShowViewStrategy.ShowViewInPopupWindow(dialogView, Sub()
            Application.ShowViewStrategy.ShowMessage("You've got mail.")
        End Sub, Sub()
            Application.ShowViewStrategy.ShowMessage("Nothing happened.")
        End Sub)
    End Sub
End Class

<DomainComponent>
Public Class MyDialog
    Public Sub New(ByVal message As String)
        Me.Message = message
    End Sub
    Private privateMessage As String
    Public Property Message() As String
        Get
            Return privateMessage
        End Get
        Private Set(ByVal value As String)
            privateMessage = value
        End Set
    End Property
End Class

You can also use a PopupWindowShowAction to show a Views in a popup window. The Add an Action that Displays a Pop-up Window article describes this approach in detail.

Note

ASP.NET applications have certain specifics:

• The ShowViewInPopupWindow method can be used on XafCallbackManager callbacks initiated by the RaiseXafCallback script. It cannot be used on callbacks of controls (e.g., grid sorting).
• It is not possible to pause the current request to wait for user input.
• Main window is not refreshed when the Cancel button is clicked.