Skip to main content
.NET 6.0+

XafApplication.ListViewCreating Event

Occurs when creating a List View.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

public event EventHandler<ListViewCreatingEventArgs> ListViewCreating

Event Data

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

Property Description
CollectionSource Returns the collection source to be used when creating a new List View.
IsRoot Indicates whether a root View must be created. Inherited from ViewCreatingEventArgs.
ObjectSpace Returns the Object Space to be used when creating a new View. Inherited from ViewCreatingEventArgs.
View Specifies a custom List View created in a XafApplication.ListViewCreating event.
ViewID Returns the ID of the created View. Inherited from ViewCreatingEventArgs.

Remarks

Handle this event to provide a custom List View instead of a default one. Use the handler’s ListViewCreatingEventArgs.View parameter to get information on the created List View. To do this, use the application’s XafApplication.FindModelView method passing the View ID as a parameter. To create a List View, use the collection source passed as the handler’s ListViewCreatingEventArgs.CollectionSource parameter. To specify whether the List View is root, use the handler’s ViewCreatingEventArgs.IsRoot parameter.

The following example demonstrates how to handle the ListViewCreating event:

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Model;

namespace MySolution.Module {
    public sealed partial class MySolutionModule : ModuleBase {
        public override void Setup(XafApplication application) {
            base.Setup(application);
            application.ListViewCreating += application_ListViewCreating;
        }
        void application_ListViewCreating(object sender, ListViewCreatingEventArgs e) {
            IModelListView modeListView = ((XafApplication)sender).FindModelView(e.ViewID) as IModelListView;
            if (modeListView != null) {
                modeListView.MasterDetailMode = MasterDetailMode.ListViewAndDetailView;
            }
        }
    }
}
See Also