Skip to main content
.NET Framework 4.6.2+

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

XafApplication.ListViewCreating Event

Occurs when creating a List View.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v24.2.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