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

魅力磁場發表於2020-09-25

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應用程式很有用!
 

 

 

相關文章