[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Collapse]eXpressApp Framework
 [Expand]Fundamentals
 [Expand]Getting Started
 [Expand]Concepts
 [Expand]Design-Time Features
 [Expand]Deployment
 [Expand]Task-Based Help
  Frequently Asked Questions (FAQ)
 [Collapse]API Reference
  [Expand]DevExpress.EasyTest.Framework
  [Expand]DevExpress.ExpressApp
  [Expand]DevExpress.ExpressApp.Actions
  [Expand]DevExpress.ExpressApp.AuditTrail
  [Expand]DevExpress.ExpressApp.Chart
  [Expand]DevExpress.ExpressApp.Chart.Web
  [Expand]DevExpress.ExpressApp.Chart.Win
  [Expand]DevExpress.ExpressApp.CloneObject
  [Expand]DevExpress.ExpressApp.ConditionalAppearance
  [Expand]DevExpress.ExpressApp.Dashboards
  [Expand]DevExpress.ExpressApp.Dashboards.Web
  [Expand]DevExpress.ExpressApp.Dashboards.Win
  [Expand]DevExpress.ExpressApp.Data
  [Expand]DevExpress.ExpressApp.DC
  [Expand]DevExpress.ExpressApp.DC.ClassGeneration
  [Expand]DevExpress.ExpressApp.Editors
  [Expand]DevExpress.ExpressApp.EF
  [Expand]DevExpress.ExpressApp.EF.Utils
  [Expand]DevExpress.ExpressApp.FileAttachments.Web
  [Expand]DevExpress.ExpressApp.FileAttachments.Win
  [Expand]DevExpress.ExpressApp.Filtering
  [Expand]DevExpress.ExpressApp.HtmlPropertyEditor.Web
  [Expand]DevExpress.ExpressApp.HtmlPropertyEditor.Win
  [Expand]DevExpress.ExpressApp.Kpi
  [Expand]DevExpress.ExpressApp.Layout
  [Expand]DevExpress.ExpressApp.Maps.Mobile
  [Expand]DevExpress.ExpressApp.Maps.Mobile.Editors
  [Expand]DevExpress.ExpressApp.Maps.Web
  [Expand]DevExpress.ExpressApp.Maps.Web.Helpers
  [Expand]DevExpress.ExpressApp.MiddleTier
  [Expand]DevExpress.ExpressApp.Mobile
  [Expand]DevExpress.ExpressApp.Mobile.Editors
  [Expand]DevExpress.ExpressApp.Mobile.MobileModel
  [Expand]DevExpress.ExpressApp.Mobile.SystemModule
  [Expand]DevExpress.ExpressApp.Mobile.Templates
  [Expand]DevExpress.ExpressApp.Model
  [Expand]DevExpress.ExpressApp.Model.Core
  [Expand]DevExpress.ExpressApp.Model.NodeGenerators
  [Expand]DevExpress.ExpressApp.ModelEditor
  [Expand]DevExpress.ExpressApp.Notifications
  [Expand]DevExpress.ExpressApp.Notifications.Web
  [Expand]DevExpress.ExpressApp.Notifications.Win
  [Expand]DevExpress.ExpressApp.Office.Win
  [Expand]DevExpress.ExpressApp.PivotChart
  [Expand]DevExpress.ExpressApp.PivotChart.Web
  [Expand]DevExpress.ExpressApp.PivotChart.Win
  [Expand]DevExpress.ExpressApp.PivotGrid
  [Expand]DevExpress.ExpressApp.PivotGrid.Web
  [Expand]DevExpress.ExpressApp.PivotGrid.Win
  [Expand]DevExpress.ExpressApp.Reports
  [Expand]DevExpress.ExpressApp.Reports.Web
  [Expand]DevExpress.ExpressApp.Reports.Win
  [Expand]DevExpress.ExpressApp.ReportsV2
  [Expand]DevExpress.ExpressApp.ReportsV2.Mobile
  [Expand]DevExpress.ExpressApp.ReportsV2.Web
  [Expand]DevExpress.ExpressApp.ReportsV2.Win
  [Expand]DevExpress.ExpressApp.Scheduler
  [Expand]DevExpress.ExpressApp.Scheduler.Web
  [Expand]DevExpress.ExpressApp.Scheduler.Win
  [Expand]DevExpress.ExpressApp.ScriptRecorder
  [Expand]DevExpress.ExpressApp.ScriptRecorder.Web
  [Expand]DevExpress.ExpressApp.ScriptRecorder.Win
  [Expand]DevExpress.ExpressApp.Security
  [Expand]DevExpress.ExpressApp.Security.Adapters
  [Expand]DevExpress.ExpressApp.Security.ClientServer.Wcf
  [Expand]DevExpress.ExpressApp.Security.EF.Adapters
  [Expand]DevExpress.ExpressApp.Security.Strategy
  [Expand]DevExpress.ExpressApp.Security.Xpo.Adapters
  [Expand]DevExpress.ExpressApp.StateMachine
  [Expand]DevExpress.ExpressApp.SystemModule
  [Expand]DevExpress.ExpressApp.Templates
  [Expand]DevExpress.ExpressApp.Templates.ActionContainers
  [Expand]DevExpress.ExpressApp.TreeListEditors
  [Expand]DevExpress.ExpressApp.TreeListEditors.Web
  [Expand]DevExpress.ExpressApp.TreeListEditors.Win
  [Expand]DevExpress.ExpressApp.Updating
  [Expand]DevExpress.ExpressApp.Utils
  [Expand]DevExpress.ExpressApp.Validation
  [Expand]DevExpress.ExpressApp.Validation.Web
  [Expand]DevExpress.ExpressApp.Validation.Win
  [Expand]DevExpress.ExpressApp.ViewVariantsModule
  [Expand]DevExpress.ExpressApp.Web
  [Expand]DevExpress.ExpressApp.Web.Controls
  [Expand]DevExpress.ExpressApp.Web.Editors
  [Expand]DevExpress.ExpressApp.Web.Editors.ASPx
  [Expand]DevExpress.ExpressApp.Web.SystemModule
  [Expand]DevExpress.ExpressApp.Web.Templates
  [Expand]DevExpress.ExpressApp.Web.Utils
  [Collapse]DevExpress.ExpressApp.Win
   [Expand]CustomGetImageEventArgs Class
   [Expand]CustomHandleExceptionEventArgs Class
   [Expand]DefaultOverlayFormOptions Class
    FileLocation Enumeration
   [Expand]IModelOptionsTabbedMdiLayout Interface
   [Expand]ISplash Interface
   [Expand]ISupportOverlayForm Interface
   [Expand]ISupportSplashTypes Interface
   [Expand]ISupportUpdateSplash Interface
   [Collapse]MdiShowViewStrategy Class
     MdiShowViewStrategy Members
    [Expand]MdiShowViewStrategy Constructor
    [Expand]MdiShowViewStrategy Properties
    [Expand]MdiShowViewStrategy Events
    [Expand]MdiShowViewStrategy Methods
   [Expand]QueryIconEventArgs Class
   [Expand]ShowInMultipleWindowsStrategy Class
   [Expand]ShowInSingleWindowStrategy Class
    SplashType Enumeration
   [Expand]WinApplication Class
   [Expand]WinShowViewStrategyBase Class
   [Expand]WinWindow Class
   [Expand]WinWindowShowingEventArgs Class
  [Expand]DevExpress.ExpressApp.Win.Core
  [Expand]DevExpress.ExpressApp.Win.Editors
  [Expand]DevExpress.ExpressApp.Win.Model
  [Expand]DevExpress.ExpressApp.Win.SystemModule
  [Expand]DevExpress.ExpressApp.Win.Templates
  [Expand]DevExpress.ExpressApp.Win.Templates.Navigation
  [Expand]DevExpress.ExpressApp.Win.Utils
  [Expand]DevExpress.ExpressApp.Workflow
  [Expand]DevExpress.ExpressApp.Workflow.Win
  [Expand]DevExpress.ExpressApp.Xpo
  [Expand]DevExpress.ExpressApp.Xpo.Utils
  [Expand]DevExpress.Persistent.Base
  [Expand]DevExpress.Persistent.Base.General
  [Expand]DevExpress.Persistent.Base.ReportsV2
  [Expand]DevExpress.Persistent.Base.Security
  [Expand]DevExpress.Persistent.BaseImpl
  [Expand]DevExpress.Persistent.BaseImpl.EF
  [Expand]DevExpress.Persistent.BaseImpl.EF.PermissionPolicy
  [Expand]DevExpress.Persistent.BaseImpl.PermissionPolicy
  [Expand]DevExpress.Persistent.Validation
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

MdiShowViewStrategy Class

A Show View Strategy that uses a multiple document interface and can be used as an alternative to the default ShowInMultipleWindowsStrategy.

Namespace:DevExpress.ExpressApp.Win
Assembly:DevExpress.ExpressApp.Win.v19.1.dll

Expanded Syntax

Expanded Remarks

The built-in MainForm Template includes a DevExpress.XtraBars.Docking2010.DocumentManager component. The DocumentManager is a non-visual object that displays content via Documents. Documents can be presented in different ways based on the DocumentManager's view. There are two Document Manager view types: DevExpress.XtraBars.Docking2010.Views.NativeMdi.NativeMdiView and DevExpress.XtraBars.Docking2010.Views.Tabbed.TabbedView. The MdiShowViewStrategy uses the DocumentManager for showing XAF Views. Its MdiMode property value is used to set the DocumentManager's view. The following values are possible:

  • When the MdiMode property is set to MdiMode.Tabbed, the Document Manager uses the Tabbed MDI view. This means that Views are invoked in separate tabs:

    In this mode, the MdiShowViewStrategy supports docking. Users can dock, group and arrange tabs or windows as desired. You can also Shift+Click a navigation item or an object reference, and the corresponding View will be invoked in a new window. Pressing Ctrl+Tab activates a Document Selector. It allows you to switch between Views easily. To learn more about the capabilities that are provided in the Document Manager together with a DockManager, refer to the Interaction with Dock Panels topic. In addition, try the Ribbon, Toolbar & Docking | Tutorials | Document Manager Demo supplied with the DXperience installation. The MdiShowViewStrategy saves the arrangement of the open tabs when closing the application and restores them when re-opening the application. For optimal performance of the tabbed mode, delayed loading is implemented for restored tabs. This means that only controls of the active tab are created on application startup. At the same time, you can refuse saving the tabs layout by setting the RestoreTabbedMdiLayout property of the Options node to false in the Model Editor.

    Note

    In the Tabbed mode, bar items from a child form are merged with bar items from a parent form. Merging is performed based on captions of the items (see MDI Merging). When localizing, ensure that you specify different localized values for Action Container captions. Otherwise, unwanted Action duplication may occur.

  • When the MdiMode property is set to MdiMode.Standard, the Document Manager uses the Native MDI view. This means that Views are invoked in separate Windows:

    Note

    Model Editor prohibits using the Standard mode together with the Ribbon interface. The Document Manager has not been thoroughly tested for this configuration as we have found it much less usable than others. This configuration can potentially lead to errors. In conjunction with the Ribbon, the Tabbed mode provides better usability.

You can access the DocumentManager to customize its default settings. To do this, cast the MainForm Template by the IDocumentsHostWindow interface and get the value of its DocumentManager property. To see an example, refer to the How to: Access the Document Manager topic.

By default, XAF Windows Forms applications use the ShowInMultipleWindowsStrategy. To use another Strategy, specify the Application Model's IModelOptionsWin.UIType property of the Application | Options node. Alternatively, you can manually instantiate the required Strategy and assign it to the XafApplication.ShowViewStrategy property.

For general information on Show View Strategies, refer to the ShowViewStrategyBase class description.

Expanded Inheritance Hierarchy

System.Object
    ShowViewStrategyBase
       WinShowViewStrategyBase
          MdiShowViewStrategy

Expanded See Also

Is this topic helpful?​​​​​​​