Window Manager 简介
Caliburn Micro的窗口管理器可以通过ViewModel创建窗口,你只需要传递一个ViewModel实例给窗口管理器,窗口管理器就会自动查找对应的View,并作为一个窗口或对话框打开,在打开前还可以对view的部分依赖属性进行配置。
窗口管理器在CM中非常重要,应用程序创建新窗口,弹出对话框等使用窗口管理器都是非常方便的。但是在CM中WindowManager在每个平台(WPF、Silverlight、WindowsPhone、WinRT)上的实现都不相同。所以,想完全了解有点困难,就连官方文档都没有详细说明。所以,为了简便起见,本文也只对WPF上的WindowManager进行介绍。
WPF中应用Window Manager
要使用窗口管理器,就需要有一个窗口管理器的对象。我们通常做法就是在Bootstrapper中配置IOC时,创建一个WindowManager并导入到IOC容器(可以参考学习之前Bootstrapper配置相关文章)。配置IOC的代码可以是这样的(在本文中都是以MEF为IOC容器为示例的):
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(container);
container.Compose(batch);
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
然后我们在需要使用WindowManager的ViewModel中提取WindowManager对象。具体做法如下:
[Export(typeof(ShellViewModel))]
public class ShellViewModel : PropertyChangedBase
{
private readonly IWindowManager _windowManager;
[ImportingConstructor] //必须加入这个,这是因为用MEF在创建ShellViewModel实例时,有[ImportingConstructor]标记的构造函数的参数会自动使用容器内相应的export对象
public ShellViewModel(IWindowManager windowManager)
{
_windowManager = windowManager;
}
...
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
使用WindowManager反而很简单,如下代码会创建一个新的ShellViewModel,并根据ShellViewModel找到ShellView,然后显示ShellView窗口,ShellViewModel会成为ShellView的dataContext。
public void NewWindow()
{
_windowManager.ShowWindow(new ShellViewModel(_windowManager));
}
- 1
- 2
- 3
- 4
Window Manager中打开窗口,对话框和弹出窗口,都可以,只需要调用不同的方法即可。你可以在 Caliburn Micro 自带的 HelloWindowManager 示例中,看到WindowManager窗口管理器的更多用法。
WindowManager的setting参数
在WindowManager创建窗口时,可以传递参数给新的窗口的属性。这能更好的使您根据您的需要,更细的控制您的应用程序。可以参考如下示例:
public void NewWindow()
{
var settings = new Dictionary<string, object> { { "Topmost", true }, { "Owner", GetView() } };
//Owner不是依赖属性不能绑定,但在这里设置是可以的
_windowManager.ShowDialog(new ConfigViewModel(), null, settings);
}
- 1
- 2
- 3
- 4
- 5
- 6
上述示例中,我把新窗口的Topmost设置为true,Owner设置为当前ViewModel绑定的窗口(如果当前ViewModel继承了ViewAware或Screen等,就可以调用GetView方法获取View对象)。
自定义WindowManager
有些情况下,实现自定义的窗口管理器是有用的。如果你需要在所有窗口实例中设置属性都是一样的值,用它就很好。例如,属性可能包括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;
}
- 1
- 2
- 3
- 4
- 5
- 6
在这个方法中,我们首先通过调用base.EnsureWindow()来创建窗口实例。接下来,你可以设置一下你想要的窗口中的属性,然后简单地返回窗口实例。
之后只需要用自定义窗口管理器代替默认的窗口管理器,就可以实现你想要的效果。比如你可以用如下方式添加你的自定义窗口管理器:
batch.AddExportedValue<IWindowManager>(new AppWindowManager());
- 1
这样会导致所有使用窗口管理器的地方,报告CM内部都会采用你的自定义窗口管理器。