Caliburn.Micro入門教程5，視窗管理器

Caliburn.Micro入門教程1
Caliburn.Micro入門教程2，瞭解Data Binding和Events
Caliburn.Micro入門教程3，事件和引數
Caliburn.Micro入門教程4，事件聚合器
Caliburn.Micro入門教程5，視窗管理器
Caliburn.Micro入門教程6，Screens和Conductors 簡介​​​​​​​

 

你們中許多人在啃Caliburn Micro的時候，會發現沒有太多提及到視窗管理器。出於這個原因，我會簡單地解釋一下我瞭解的東西，我不會涵蓋一切。

為了演示如何使用視窗管理器，我們將擴充套件我們在本系列的第一篇部落格。

1.Using a Window Manager

你可能還記得在入門的部落格文章說的，我們做的第一件事就是從專案中刪除MainWindow.xaml 。 Caliburn Micro需要初始化視窗，設定它的data context（資料上下文）和給我們顯示相應的檢視。視窗管理器就是有效的處理它們的機制之一。
當您執行構建Caliburn Micro應用程式，視窗管理器被自動用於建立啟動視窗。對於小型的應用程式，對視窗管理器只需要瞭解這些就行。當你正在構建需要顯示其他視窗或對話方塊等較大的應用程式時，就是時候來學習如何使用視窗管理器了。
為了證明這一點，我們將新增一個按鈕，點選後，程式將開啟一個新視窗。
首先，在AppView.xaml中新增一個按鈕，然後將click事件和AppViewModel.cs中的方法關聯。使用Caliburn Micro約定在前面的教程中解釋了你可以做到這一點。我定義方法名為“OpenWindow ” 。
在的openWindow方法中，我們將需要訪問視窗管理器的一個例項。雖然我們可以簡單地建立新視窗，而不使用視窗管理器，但是這是最好的做法，用來獲取Caliburn Micro提供給應用程式的，保持全球化的視窗管理器例項。我們可以通過在AppViewModel.cs建構函式中，新增一個IWindowManager並將其儲存在一個欄位上，來做到這一點。你可能還記得這個部落格系列的第4部分，當你在一個ViewModel建立一個建構函式時，至少要有1個引數。
下面是3個簡單的步驟回顧一下：

1。更新bootstrapper載入程式如下。記得新增System.ComponentModel.Composition。dll引用。

using Caliburn.Micro;
using System.ComponentModel.Composition;
using System.ComponentModel.Composition.Hosting;
using System.ComponentModel.Composition.Primitives;
 
public class AppBootstrapper : Bootstrapper<AppViewModel>
{
  private CompositionContainer container;
 
  protected override void Configure()
  {
    container = new CompositionContainer(new AggregateCatalog(AssemblySource.Instance.Select(x => new AssemblyCatalog(x)).OfType<ComposablePartCatalog>()));
 
    CompositionBatch batch = new CompositionBatch();
 
    batch.AddExportedValue<IWindowManager>(new WindowManager());
    batch.AddExportedValue<IEventAggregator>(new EventAggregator());
    batch.AddExportedValue(container);
 
    container.Compose(batch);
  }
 
  protected override object GetInstance(Type serviceType, string key)
  {
    string contract = string.IsNullOrEmpty(key) ? AttributedModelServices.GetContractName(serviceType) : key;
    var exports = container.GetExportedValues<object>(contract);
 
    if (exports.Count() > 0)
    {
      return exports.First();
    }
 
    throw new Exception(string.Format("Could not locate any instances of contract {0}.", contract));
  }
}

2. 在 AppViewModel 類中，新增”Export“特性: 

[Export(typeof(AppViewModel))]
public class AppViewModel : PropertyChangedBase
{
  ...
}

3. 在 AppViewModel 類中，為建構函式新增 ”ImportingConstructor“特性:

private readonly IWindowManager _windowManager;
 
[ImportingConstructor]
public AppViewModel(IWindowManager windowManager)
{
  _windowManager = windowManager;
}

現在我們可以使用Window Manager例項在我們的openWindow方法來開啟一個新視窗。為了保持本教程的簡單，我們將簡單地建立也使用AppViewModel作為新視窗的data context資料上下文。使用下面的程式碼來完成的：

public void OpenWindow()
{
  _windowManager.ShowWindow(new AppViewModel(_windowManager));
}

現在執行一下，然後按下按鈕，會看到另一個視窗出現。
所有我們需要做的是通過傳遞一個ViewModel的一個例項。然後從建立視窗例項，到為我們顯示ViewModel相應的View的一切，都會完成。Caliburn Micro再次使我們的生活更輕鬆！

Window Manager有各種各樣的方法和方法過載開啟視窗，對話方塊和彈出視窗。所有這些方法是相當直截了當的，易於使用。
你可以在 Caliburn Micro 自帶的 HelloWindowManager 示例中，看到WindowManager視窗管理器的更多用法。
還有一件事，我想看看'settings'引數。在這裡，你可以傳遞dynamic型別的動態物件來給新的視窗中設定屬性。這能更好的使您根據您的需要，更細的控制您的應用程式。
下面是一個例子，我設定了WindowStartupLocation為 manual 而不是 center-owner。

2.Custom Window Managers

 有些情況下，實現自定義的視窗管理器是有用的。如果你需要在所有視窗例項中設定屬性都是一樣的值，用它就很好。例如，屬性可能包括icon圖示，視窗狀態，視窗大小和自定義程式樣式。我發現在Windows中最常設定的屬性是“SizeToContent”。預設情況下，Caliburn Micro是設定SizeToContent.WidthAndHeight。這意味著該視窗根據它的內容自動調整自身大小。雖然有時可以方便的這樣做，但我發現這會導致一些問題：
某些應用程式的佈局和設定視窗時，預設情況下最大化會導致越界。
建立一個自定義的視窗管理器是非常簡單的。首先新增一個繼承於“WindowManager”的類，接下來，可以重寫“EnsureWindow”方法，做一些類似如下：

protected override Window EnsureWindow(object model, object view, bool isDialog)
{
  Window window = base.EnsureWindow(model, view, isDialog); 
  window.SizeToContent = SizeToContent.Manual;
 
  return window;
}

在這個方法中，我們首先通過呼叫base.EnsureWindow（）來建立視窗例項。接下來，你可以設定一下你想要的視窗中的屬性，然後簡單地返回視窗例項。最後一步是設定自定義的視窗管理器，以在全球範圍內使用的應用程式的例項。在這篇部落格文章的第一個程式碼片段，我們進行修改載入程式。在這裡，你可以看到我們給“CompositionBatch”新增了一個WindowManager例項。您可以新增一個和下面的例項類似的，自定義的視窗管理器的例項：

batch.AddExportedValue<IWindowManager>(new AppWindowManager());

這就是我想要的一切，來使用視窗管理器，我希望你覺得它在構建Caliburn Micro的WPF應用程式很有用！