From 2b908f18ebd0885557e402c49faedea0ac62220e Mon Sep 17 00:00:00 2001
From: Markus Ewald <cygon@nuclex.org>
Date: Wed, 13 Feb 2019 10:30:19 +0000
Subject: [PATCH] The window manager can now also create just view models
 (without immediately binding a view); added MultiPageViewModel as a base
 class for the common case of view models that embed multi pages they can
 switch between; added missing copyright statement for the late checked
 synchronization context

git-svn-id: file:///srv/devel/repo-conversion/nuwi@49 d2e56fa2-650e-0410-a79f-9358c0239efd
---
 Nuclex.Windows.Forms (net-4.0).csproj |  2 ++
 Source/IWindowManager.cs              | 18 ++++++++++++++++++
 Source/LateCheckedSynchronizer.cs     | 22 +++++++++++++++++++++-
 Source/WindowManager.cs               | 19 +++++++++++++++++++
 4 files changed, 60 insertions(+), 1 deletion(-)

diff --git a/Nuclex.Windows.Forms (net-4.0).csproj b/Nuclex.Windows.Forms (net-4.0).csproj
index e57c2cb..05bbbb0 100644
--- a/Nuclex.Windows.Forms (net-4.0).csproj	
+++ b/Nuclex.Windows.Forms (net-4.0).csproj	
@@ -76,6 +76,7 @@
     <Compile Include="Source\ViewModels\DialogViewModel.Test.cs">
       <DependentUpon>DialogViewModel.cs</DependentUpon>
     </Compile>
+    <Compile Include="Source\ViewModels\MultiPageViewModel.cs" />
     <Compile Include="Source\ViewModels\ThreadedAction.cs" />
     <Compile Include="Source\ViewModels\ThreadedAction.Test.cs">
       <DependentUpon>ThreadedAction.cs</DependentUpon>
@@ -157,6 +158,7 @@
   </ItemGroup>
   <ItemGroup>
     <Folder Include="Resources\" />
+    <Folder Include="Source\Controls\" />
   </ItemGroup>
   <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
   <!-- To modify your build process, add your task inside one of the targets below and uncomment it. 
diff --git a/Source/IWindowManager.cs b/Source/IWindowManager.cs
index 1685506..31e75bd 100644
--- a/Source/IWindowManager.cs
+++ b/Source/IWindowManager.cs
@@ -70,6 +70,24 @@ namespace Nuclex.Windows.Forms {
     Control CreateView<TViewModel>(TViewModel viewModel = null)
       where TViewModel : class;
 
+    /// <summary>Creates a view model without a matching view</summary>
+    /// <typeparam name="TViewModel">Type of view model that will be created</typeparam>
+    /// <returns>The new view model</returns>
+    /// <remarks>
+    ///   <para>
+    ///     This is useful if a view model needs to create child view models (i.e. paged container
+    ///     and wants to ensure the same dependency injector (if any) if used as the window
+    ///     manager uses for other view models it creates.
+    ///   </para>
+    ///   <para>
+    ///     This way, view models can set up their child view models without having to immediately
+    ///     bind a view to them. Later on, views can use the window manager to create a matching
+    ///     child view and store it in a container.
+    ///   </para>
+    /// </remarks>
+    TViewModel CreateViewModel<TViewModel>()
+      where TViewModel : class;
+
   }
 
 } // namespace Nuclex.Windows.Forms
diff --git a/Source/LateCheckedSynchronizer.cs b/Source/LateCheckedSynchronizer.cs
index a5fb49b..65bbaf2 100644
--- a/Source/LateCheckedSynchronizer.cs
+++ b/Source/LateCheckedSynchronizer.cs
@@ -1,4 +1,24 @@
-using System;
+#region CPL License
+/*
+Nuclex Framework
+Copyright (C) 2002-2019 Nuclex Development Labs
+
+This library is free software; you can redistribute it and/or
+modify it under the terms of the IBM Common Public License as
+published by the IBM Corporation; either version 1.0 of the
+License, or (at your option) any later version.
+
+This library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+IBM Common Public License for more details.
+
+You should have received a copy of the IBM Common Public
+License along with this library
+*/
+#endregion
+
+using System;
 using System.ComponentModel;
 using System.Windows.Forms;
 
diff --git a/Source/WindowManager.cs b/Source/WindowManager.cs
index dfb80ba..dba4b87 100644
--- a/Source/WindowManager.cs
+++ b/Source/WindowManager.cs
@@ -239,6 +239,25 @@ namespace Nuclex.Windows.Forms {
       return viewControl;
     }
 
+    /// <summary>Creates a view model without a matching view</summary>
+    /// <typeparam name="TViewModel">Type of view model that will be created</typeparam>
+    /// <returns>The new view model</returns>
+    /// <remarks>
+    ///   <para>
+    ///     This is useful if a view model needs to create child view models (i.e. paged container
+    ///     and wants to ensure the same dependency injector (if any) if used as the window
+    ///     manager uses for other view models it creates.
+    ///   </para>
+    ///   <para>
+    ///     This way, view models can set up their child view models without having to immediately
+    ///     bind a view to them. Later on, views can use the window manager to create a matching
+    ///     child view and store it in a container.
+    ///   </para>
+    /// </remarks>
+    public TViewModel CreateViewModel<TViewModel>() where TViewModel : class {
+      return (TViewModel)CreateInstance(typeof(TViewModel));
+    }
+
     /// <summary>Locates the view that will be used to a view model</summary>
     /// <param name="viewModelType">
     ///   Type of view model for which the view will be located