XafApplication.CreateDetailView(IObjectSpace, Object) Method

Creates a Detail View based on information specified in the Application Model for the type of the specified object.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public DetailView CreateDetailView(
    IObjectSpace objectSpace,
    object obj
)

VB.NET

Public Function CreateDetailView(
    objectSpace As IObjectSpace,
    obj As Object
) As DetailView

Parameters

Name	Type	Description
objectSpace	IObjectSpace	An IObjectSpace object representing the Object Space which is used to work with the new Detail View DetailView.CurrentObject. This object is assigned to the View.ObjectSpace property.
obj	Object	An object which is represented by the new Detail View. This object is assigned to the DetailView.CurrentObject property.

Returns

Type	Description
DetailView	A Detail View that represents the object passed as the obj parameter.

Remarks

Use this method to create a Detail View for the object specified by the obj parameter. The information on the created Detail View is taken from the Application Model‘ node specified by the IModelClass.DefaultDetailView property of the corresponding IModelClass node.

The object specified in the obj parameter should belong to the Object Space specified in the objectSpace parameter. To pass an object from another Object Space to this Object Space, use the IObjectSpace.GetObject method.

The Object Space specified in the objectSpace parameter should not belong to another View. To pass an Object Space used by another (parent) View to the created DetailView, either use the CreateDetailView method overload with the isRoot parameter, or set the IsRoot property of the created DetailView to false.

The example below demonstrates how to open an object’s Detail View via a PopupWindowShowAction.

C#

using System;
using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Actions;
using DevExpress.Persistent.Base;
using DevExpress.Persistent.BaseImpl;
// ...
public class ShowDetailViewController : ObjectViewController<ListView, Person> {
    public ShowDetailViewController() {
        PopupWindowShowAction showDetailViewAction = new PopupWindowShowAction(
            this, "ShowDetailView", PredefinedCategory.Edit);
        showDetailViewAction.SelectionDependencyType = SelectionDependencyType.RequireSingleObject;
        showDetailViewAction.CustomizePopupWindowParams += ShowDetailViewAction_CustomizePopupWindowParams;
    }
    private void ShowDetailViewAction_CustomizePopupWindowParams(
        object sender, CustomizePopupWindowParamsEventArgs e) {
        IObjectSpace objectSpace = Application.CreateObjectSpace(typeof(Person));
        Object currentObject = objectSpace.GetObject(View.CurrentObject);
        if(currentObject != null) {
            e.View = Application.CreateDetailView(objectSpace, currentObject);
        }
        else {
            objectSpace.Dispose();
        }
    }
}

VB.NET

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

Public Class ShowDetailViewController
    Inherits ObjectViewController(Of ListView, Person)
    Public Sub New()
        Dim showDetailViewAction As New PopupWindowShowAction(Me, "ShowDetailView", PredefinedCategory.Edit)
        showDetailViewAction.SelectionDependencyType = SelectionDependencyType.RequireSingleObject
        AddHandler showDetailViewAction.CustomizePopupWindowParams, _
            AddressOf ShowDetailViewAction_CustomizePopupWindowParams
    End Sub
    Private Sub ShowDetailViewAction_CustomizePopupWindowParams(ByVal sender As Object, _
        ByVal e As CustomizePopupWindowParamsEventArgs)
        Dim objectSpace As IObjectSpace = Application.CreateObjectSpace(GetType(Person))
        Dim currentObject As Object = objectSpace.GetObject(View.CurrentObject)
        If currentObject IsNot Nothing Then
            e.View = Application.CreateDetailView(objectSpace, currentObject)
        Else
            objectSpace.Dispose()
        End If
    End Sub
End Class

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the CreateDetailView(IObjectSpace, Object) method.

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-show-persistent-objects-in-a-non-persistent-objects-view/CS/ComplexDialogSample.Module/Controllers/MyController.cs#L37

e.Context = TemplateContext.PopupWindow;
e.View = Application.CreateDetailView(os, new OrderTemplate(((DevExpress.ExpressApp.Xpo.XPObjectSpace)os).Session));
((DetailView)e.View).ViewEditMode = ViewEditMode.Edit;

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

IObjectSpace objectSpace = Application.CreateObjectSpace(typeof(Singleton));
DetailView detailView = Application.CreateDetailView(objectSpace, objectSpace.GetObjects<Singleton>()[0]);
detailView.ViewEditMode = ViewEditMode.Edit;

XAF_how-to-show-filter-dialog-before-listview/CS/E1554.Module/ShowFilterDialogController.cs#L37

newViewFilterContainer.Filter = GetFilterObject(persistentObjectSpace, ((IModelListViewAdditionalCriteria)oldListView.Model).AdditionalCriteria, newViewFilterContainer.ObjectType);
DetailView filterDetailView = Application.CreateDetailView(nonPersistentObjectSpace, newViewFilterContainer);
filterDetailView.Caption = String.Format("Filter for the {0} ListView", oldListView.Caption);

xaf-how-to-show-a-new-object-detail-view-via-the-navigation-control/CS/NewObjectFromNavigationExample.Module/Controllers/NewObjectFromNavigationController.cs#L19

Issue newIssue = objectSpace.CreateObject<Issue>();
DetailView detailView = Application.CreateDetailView(objectSpace, newIssue);
detailView.ViewEditMode = DevExpress.ExpressApp.Editors.ViewEditMode.Edit;

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

var obj = new FindArticlesDialog();
var detailView = Application.CreateDetailView(objectSpace, obj);
detailView.ViewEditMode = DevExpress.ExpressApp.Editors.ViewEditMode.Edit;

VB.NET

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

e.Context = TemplateContext.PopupWindow
e.View = Application.CreateDetailView(os, New OrderTemplate(DirectCast(os, DevExpress.ExpressApp.Xpo.XPObjectSpace).Session))
CType(e.View, DetailView).ViewEditMode = ViewEditMode.Edit

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

Dim objectSpace As IObjectSpace = Application.CreateObjectSpace(GetType(Singleton))
Dim detailView As DetailView = Application.CreateDetailView(objectSpace, objectSpace.GetObjects(Of Singleton)()(0))
detailView.ViewEditMode = ViewEditMode.Edit

XAF_how-to-show-filter-dialog-before-listview/VB/E1554.Module/ShowFilterDialogController.vb#L38

newViewFilterContainer.Filter = GetFilterObject(persistentObjectSpace, DirectCast(oldListView.Model, IModelListViewAdditionalCriteria).AdditionalCriteria, newViewFilterContainer.ObjectType)
Dim filterDetailView As DetailView = Application.CreateDetailView(nonPersistentObjectSpace, newViewFilterContainer)
filterDetailView.Caption = String.Format("Filter for the {0} ListView", oldListView.Caption)

xaf-how-to-show-a-new-object-detail-view-via-the-navigation-control/VB/NewObjectFromNavigationExample.Module/Controllers/NewObjectFromNavigationController.vb#L21

Dim newIssue As Issue = objectSpace.CreateObject(Of Issue)()
Dim detailView As DetailView = Application.CreateDetailView(objectSpace, newIssue)
detailView.ViewEditMode = DevExpress.ExpressApp.Editors.ViewEditMode.Edit

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

Dim obj = New FindArticlesDialog()
Dim detailView = Application.CreateDetailView(objectSpace, obj)
detailView.ViewEditMode = DevExpress.ExpressApp.Editors.ViewEditMode.Edit