ShowViewParameters.TargetWindow Property

Specifies the type of the Window that displays the target View.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v25.2.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public TargetWindow TargetWindow { get; set; }

VB.NET

Public Property TargetWindow As TargetWindow

Property Value

Type	Default	Description
TargetWindow	Default	The type of the target window.

Available values:

Name	Description
Default	The active ShowViewStrategyBase determines the type of Window to display the target View.
Current	The current Window (Frame) displays the target View.
NewWindow	A newly created Window or tab (based on the active ShowViewStrategyBase) displays the target View.
NewModalWindow	A newly created modal Window displays the target View.

Remarks

The TargetWindow property specifies the Window where the CreatedView appears. XAF determines the particular target window type based on the combination of the following settings:

• Current Platform
• Current Show View Strategy (the UIType property value)
• TargetWindow
• NewWindowTarget

The following tables list window types that display the target View based on the specified property values.

ASP.NET Core Blazor UI

TargetWindow	UIType = SingleWindowSDI	UIType = TabbedMDI
Default	- If the current Frame is a Nested Frame, the View is displayed in a new modal Window. In other cases, the View is displayed in the current Window (Frame).	- If the current Frame is a nested frame or the current Window is a Popup Window, the View is displayed in a new modal Window. In other cases, the View is displayed in a new tab in the main Window.
Current	The View is displayed in the current Window (Frame).	The View is displayed in the current Window (Frame). If the current Window is the main Window, the View is displayed in a new tab in the main Window.
NewWindow	The View is displayed in a new modal Window.	- If the NewWindowTarget property is set to Default or MdiChild, the View is displayed in a new tab in the main Window. - If the NewWindowTarget property is set to Separate, the View is displayed in a new modal Window.
NewModalWindow	The View is displayed in a new modal Window.	The View is displayed in a new modal Window.

When the application displays the target view in a modal Window, the Window layout and appearance is defined by the PopupWindowTemplate context. The system adds a DialogController to the Window’s Frame.Controllers collection.

Windows Forms

TargetWindow	UIType = SingleWindowSDI or UIType = MultipleWindowSDI	UIType = StandardMDI or UIType = TabbedMDI
Default	If the current Frame is a Nested Frame, the behavior is equivalent to the NewModalWindow option. SingleWindowSDI: If the current Window is the main Window, the behavior is equivalent to the NewWindow option. In other cases, the View is displayed in the current Window (Frame). MultipleWindowSDI: The behavior depends on the View: - If the current View is a Detail View, the new Window displays the View template context. - If the current View is a List View, the current Window (Frame) displays the target View.	- If the current Frame is a nested frame or the current Window is a Popup Window, the View is displayed in a new modal Window. In other cases, the behavior is equivalent to the NewWindow option.
Current	The View is displayed in the current Window (Frame).	The View is displayed in the current Window (Frame). If the current Window is an Explorer Window, the behavior is equivalent to the NewWindow option.
NewWindow	The View is displayed in a new separate Window.	- If the NewWindowTarget property is set to Default or MdiChild, the View is displayed in a new MDI child Window (in the StandardMDI UI) or a new tab (in the TabbedMDI UI) in the main Window. - If the NewWindowTarget property is set to Separate, the View is displayed in a new separate Window.
NewModalWindow	The View is displayed in a new modal Window.	The View is displayed in a new modal Window.

Note

In ASP.NET Core Blazor applications, if you use ShowViewParameters to display a new window, the application does not refresh the original View after you close the window. In contrast, windows that you create with PopupWindowShowAction update the parent View when you close them.

Related GitHub Examples

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

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-filter-dialog-before-listview/CS/EFCore/DialogBeforeListViewEF/DialogBeforeListViewEF.Win/Controllers/WinShowFilterDialogController.cs#L47

e.ActionArguments.ShowViewParameters.CreatedView = filterDetailView;
e.ActionArguments.ShowViewParameters.TargetWindow = TargetWindow.NewModalWindow;
DialogController dialogCotnroller = Application.CreateController<DialogController>();

xaf-how-to-save-the-currently-opened-view-as-a-new-view-variant-at-runtime/CS/EF/ViewVariantSaveEF/ViewVariantSaveEF.Module/Controllers/UserViewVariantsController.cs#L123

    e.ShowViewParameters.Controllers.Add(dialogController);
    e.ShowViewParameters.TargetWindow = TargetWindow.NewModalWindow;
}

XAF_Non-Persistent-Objects-Edit-Linked-Persistent-Objects-Demo/CS/EFCore/NonPersistentEditEF/NonPersistentEditEF.Module/Controllers/NonPersistentObjectActivatorController.cs#L44

args.ShowViewParameters.CreatedView = detailView;
args.ShowViewParameters.TargetWindow = TargetWindow.Current;
e.Handled = true;

xaf-win-custom-button-in-lookup-property-editor/CS/WinSolution.Module.Win/MyLookupPropertyEditor.cs#L33

svp.CreatedView = Helper.Application.CreateDetailView(objectSpace, editedObject, true);
svp.TargetWindow = TargetWindow.Default;
svp.Context = TemplateContext.View;

VB.NET

xaf-win-custom-button-in-lookup-property-editor/VB/WinSolution.Module.Win/MyLookupPropertyEditor.vb#L40

svp.CreatedView = Helper.Application.CreateDetailView(objectSpace, editedObject, True)
svp.TargetWindow = TargetWindow.Default
svp.Context = TemplateContext.View