PopupWindowShowAction.CustomizePopupWindowParams Event

Occurs when generating a pop-up Window for a Pop-up Window Show Action.

Namespace: DevExpress.ExpressApp.Actions

Assembly: DevExpress.ExpressApp.v24.2.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public event CustomizePopupWindowParamsEventHandler CustomizePopupWindowParams

VB.NET

Public Event CustomizePopupWindowParams As CustomizePopupWindowParamsEventHandler

Event Data

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

Property	Description
Action	Provides access to the Pop-up Window Show Action for which the PopupWindowShowAction.CustomizePopupWindowParams event has been raised.
Application	Provides access to an XafApplication object that provides methods and properties to manage the current application.
Context	Specifies the Frame.Context of the pop-up window which is customized by a PopupWindowShowAction.CustomizePopupWindowParams event’s handler.
DialogController	Specifies a Dialog Controller which is activated for a Pop-up Window Show Action’s pop-up Window.
IsSizeable	Specifies whether the pop-up Window created for a Pop-up Window Show Action is sizable.
Maximized	Gets or sets a value that specifies whether the window is maximized.
Size	Specifies the size of a pop-up window.
View	Specifies the View that should be displayed by the Pop-up Window Show Action’s pop-up Window.

Remarks

Handle this event to specify a View for a PopupWindowShowAction to show. For this purpose, use the handler’s CustomizePopupWindowParamsEventArgs.View parameter. You can also use the CustomizePopupWindowParamsEventArgs.IsSizeable property, to specify the pop-up Window’s ability to be sizable.

The following example creates a List View and displays it via a PopupWindowShowAction.

C#

using System;
using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Actions;
using DevExpress.Persistent.Base;
using DevExpress.Persistent.BaseImpl;
// ...
public class ShowListViewController : ViewController {
    public ShowListViewController() {
        PopupWindowShowAction showListViewAction = new PopupWindowShowAction(this, "ShowListView",
            PredefinedCategory.Edit);
        showListViewAction.CustomizePopupWindowParams += ShowListViewAction_CustomizePopupWindowParams;
    }
    private void ShowListViewAction_CustomizePopupWindowParams(object sender, CustomizePopupWindowParamsEventArgs e) {
        Type objectType = typeof(Person);
        e.View = Application.CreateListView(objectType, true);
    }
}

VB.NET

Imports System
Imports DevExpress.ExpressApp
Imports DevExpress.ExpressApp.Actions
Imports DevExpress.Persistent.Base
Imports DevExpress.Persistent.BaseImpl

Public Class ShowListViewController
    Inherits ViewController
    Public Sub New()
        Dim showListViewAction As New PopupWindowShowAction(Me, "ShowListView", PredefinedCategory.Edit)
        AddHandler showListViewAction.CustomizePopupWindowParams, _
            AddressOf ShowListViewAction_CustomizePopupWindowParams
    End Sub
    Private Sub ShowListViewAction_CustomizePopupWindowParams(ByVal sender As Object, _
        ByVal e As CustomizePopupWindowParamsEventArgs)
        Dim objectType As Type = GetType(Person)
        e.View = Application.CreateListView(objectType, True)
    End Sub
End Class

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the CustomizePopupWindowParams event.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

XAF_how-to-add-custom-buttons-actions-to-the-lookup-and-popup-windows/CS/WinSolution.Module.Win/PopupListViewController.cs#L14

    );
    showPopupAction.CustomizePopupWindowParams += this.showPopupAction_CustomizePopupWindowParams;
}

xaf-how-to-show-persistent-objects-in-a-non-persistent-objects-view/CS/ComplexDialogSample.Module/Controllers/MyController.cs#L31

action.SelectionDependencyType = SelectionDependencyType.RequireMultipleObjects;
action.CustomizePopupWindowParams += new CustomizePopupWindowParamsEventHandler(action_CustomizePopupWindowParams);
action.Execute += new PopupWindowShowActionExecuteEventHandler(action_Execute);

xaf-how-to-implement-a-singleton-class/CS/HowToImplementSingleton.Module/ShowSingletonController.cs#L19

        new PopupWindowShowAction(this, "ShowSingleton", PredefinedCategory.View);
    showSingletonAction.CustomizePopupWindowParams += showSingletonAction_CustomizePopupWindowParams;
}

XAF_Non-Persistent-Objects-Filtering-Demo/CS/NonPersistentObjectsDemo.Module/Controllers/FindArticlesController.cs#L21

action = new PopupWindowShowAction(this, "FindArticles", PredefinedCategory.View);
action.CustomizePopupWindowParams += Action_CustomizePopupWindowParams;
action.Execute += Action_Execute;

VB.NET

XAF_how-to-add-custom-buttons-actions-to-the-lookup-and-popup-windows/VB/WinSolution.Module.Win/PopupListViewController.vb#L13

    Dim showPopupAction As PopupWindowShowAction = New PopupWindowShowAction(Me, "ShowPopup", DevExpress.Persistent.Base.PredefinedCategory.View)
    AddHandler showPopupAction.CustomizePopupWindowParams, AddressOf showPopupAction_CustomizePopupWindowParams
End Sub

xaf-how-to-show-persistent-objects-in-a-non-persistent-objects-view/VB/ComplexDialogSample.Module/Controllers/MyController.vb#L37

action.SelectionDependencyType = SelectionDependencyType.RequireMultipleObjects
AddHandler action.CustomizePopupWindowParams, AddressOf action_CustomizePopupWindowParams
AddHandler action.Execute, AddressOf action_Execute

xaf-how-to-implement-a-singleton-class/VB/HowToImplementSingleton.Module/ShowSingletonController.vb#L20

    Dim showSingletonAction As New PopupWindowShowAction(Me, "ShowSingleton", PredefinedCategory.View)
    AddHandler showSingletonAction.CustomizePopupWindowParams, AddressOf showSingletonAction_CustomizePopupWindowParams
End Sub

XAF_Non-Persistent-Objects-Filtering-Demo/VB/NonPersistentObjectsDemo.Module/Controllers/FindArticlesController.vb#L23

action = New PopupWindowShowAction(Me, "FindArticles", PredefinedCategory.View)
AddHandler action.CustomizePopupWindowParams, AddressOf Action_CustomizePopupWindowParams
AddHandler action.Execute, AddressOf Action_Execute