7. 组合你的UI
1. UI布局关键概念
一个组合应用UI的根节点被称作Shell,一般只有一个Shell。Shell作为应用的主页,包含一个或者多个域。域是内容占位符,可以包含一个或者多个View。有很多控件可以作为域,如ContentControl,ItemsControl,TabControl,以及一些自定义的容器控件。
1.1. Shell
作为应用根节点,Shell是Window对象,虽然Shell是window对象,但是Shell也可以定义相应的view model对象。Shell定义整体布局,一些通用UI元素,如背景,主菜单,工具栏等。Shell定义程序外观,如样式,模板,边框等等,总之,Shell是应用的全局管理者。
1.2. Views
Views 是UI的主要单元,你可以将一个User Control,Page,Data template,自定义控件作为一个View。一个控件可以是一个功能非常独立的部件,也可以是一个复用性很高的部件。
1.3. 组合View
组合view包含一个父view和一个,或者多个子view,继续拆分原因未知?
1.4. Region
Prism通过Region Manager,Region,以及Region Adapter来管理域。
RegionManager
类RegionManager负责创建和维护域集合,RegionManager使用“控件指定”适配器来将新域与主控件关联。
graph TB
A(RegionManager)
B(ItemsControlRegionAdapter)
C(Region)
D(ItemsControl)
A--find adapter for control-->B
B--Associate region-->D
B--Create region-->C
D-->C
附加属性RegionManager.RegionName将一个主控件变为一个的域,RegionManager提供RegionContext属性帮助不同Region间共享数据。
Region实现
Region是一个实现接口IRegion的类。Region能够包含任何类型的UI内容,一个Region可以包含一项或者多项内容,这取决于使用什么控件作为Region。例如一个ContentControl类型Region只能显示一个对象,一个ItemsControl类型Region则能显示多项。
1.5. 默认域功能
一个普通的Control转换为一个具有丰富功能的域需要解决诸如如何找到和实例化View,如何通知激活的view以及如何管理view的生命周期等这些问题。这依赖于两种类,Region Adapter以及Region behaviors。
1.5.1 Region Adapter
为了将UIControl变成一个region,需要有一个域适配器。域适配器负责创建域并与相应宿主控件关联。依据不同类型的主控件,Prism提供如下适配器:
- ContentControlRegionAdapter,对应ContentControl
- SelectorRegionAdapter,对应TabControl
- ItemsControlRegionAdapter,对应ItemsControl
1.5.2 Region Behavior
所谓region behavior是指为Region提供附加功能的类,这些类是拔插式部件,使用这些类可以实现view发现,支持Region Context以及扩展域实现。
Registration Behavior
类RegionManagerRegistrationBehavior负责保证Region注册在合适的RegionManager中,当一个代表Region的控件注册为另一个控件的孩子时,当前Region也需要注册到父控件的RegionManager中
Auto-Population Behavior
自动填入行为,标准类名是AutoPopulateRegionBehavior,当该行为附加在Region时,它会获取所有在该Region名下的View类型,然后创建这些view的实例并将他们添加到Region中,当域创建完成后, AutoPopulateRegionBehavior会监听RegionViewRegistry,获取绑定在该域名下的view。
Region Context Behaviors
这个域行为包含两个子行为,SyncRegionContextWithHostBehavior,BindRegionContextToDependencyObjectBehavior。顾名思义,前者将域内容同步到view,后者将域内容绑定到依赖属性。
Activation Behavior
类RegionActiveAwareBehavior负责设定一个view是否处于激活状态,这种设定是单向的,view不能通过改变自己的激活状态实现目标。view需要实现接口IActiveAware获取自己状态。
Region Lifetime Behavior
该行为用于判定是否需要将无效的view移除,判定一个view是否需要移除首先view需要实现接口IRegionMemberLifetime,依次检测如下值:
- IRegionMemberLifetime.KeepAlive 值
- DataContext's IRegionMemberLifetime.KeepAlive
- RegionMemberLifetimeAttribute.KeepAlive
- DataContext's RegionMemberLifetimeAttribute.KeepAlive
Control-Specific Behaviors
这个行为主要是用于同步selector与激活view信息,该行为仅适用于继承至Selector控件。
1.6. View Composition
在组合应用中,构造多个view你需要决定将views放在哪个位置,什么被创建以及什么位置显示。通过view 发现以及view 注入策略,我们可以实现view的创建以及显示。
1.6.1. View发现
在view发现机制中,通过RegionViewRegistry在Region名以及view类型间建立联系。当一个region创建后,会自动创建,导入需要的view。
1.6.2. View注入
在该种机制中,你获取一个region的引用,然后调用Add方法添加需要的view。可以先利用相应的RegionManager传入需要的名称,找到该view,然后执行后面操作。
1.6.3. Navigation
Prism库包含导航API,通过该API,可以实现实例化view,添加操作,并允许返回先前的view。
1.6.4. 该使用哪种?
以上两种view导入策略各具优势,适用不同场景,view 发现使用场景:
- 需要自动导入
- 一个view只有一个唯一实例被导入
view 注入适用如下场景:
- 你的应用使用导航API
- 你需要显示控制view的创建,显示,删除
- 在同一个域中,你需要显示同一个view的不同实例(包含不同数据)
- 需要控制view加入哪个Region
2. UI布局场景
2.1 实现Shell
一个应用可以有超过一个Shell,如果你的应用具有两个顶级窗口,则可以使用两个Shell
2.2 使用代码添加Region
如下,ActionContent是一个ListBox类型的容器,
//获取域管理
IRegionManager regionManager = ServiceLocator.Current.GetInstance<IRegionManager>();
//设定域管理
RegionManager.SetRegionManager(this.ActionContent, regionManager);
//添加域
RegionManager.SetRegionName(this.ActionContent, "ActionRegion");
2.3. Region导入时添加view
view发现策略下Prism可以实现自动实例化view并自动导入view,前提是需要将view与相应的域关联起来,如下:
this.regionManager.RegisterViewWithRegion("MainRegion", typeof(EmployeeView));
2.4. 通过程序在Region中显示View
这个适用view注入策略,代码如下:
// View injection
IRegion region = regionManager.Regions["MainRegion"];
var ordersView = container.Resolve<OrdersView>();
region.Add(ordersView, "OrdersView");
region.Activate(ordersView);
2.5. 在域中排列view
当一个域中包含多个view时,我们可能需要对这些view进行排列,默认情况下views按照在Region注册和添加的方式排列。为了允许View自定义view序列,Prism提供ViewSortHint标记,这个标记包含Hint属性,允许view声明它应该在region中如何排列,按照字符串大小顺序排列。