跨模块交互
一、事件聚合器
Prism中的事件聚合器相当于MvvmToolkit中的
Messenger
,可以进行订阅、发布等。
在Prism框架中,有一些类型对象是一开始就内置在IOC容器中的,例如接下来用到的
IEventAggregator
事件集合器对象。
1、IEventAggregator
IEventAggregator
:Prism框架中的内置于IOC容器中的事件聚合器类型,通过
IEventAggregator
对象可以进行事件的注册以及从IOC容器中获取事件对象。
常用成员
TEventType GetEvent<TEventType>()
:获取容器中指定类型的事件对象。
- 泛型中指定的事件对象必须是
EventBase
类型的子类,一般会通过继承EventBase
的子类PubSubEvent<TPayload>
或PubSubEvent
来创建事件类型。
2、PubSubEvent与PubSubEvent
PubSubEvent<TPayload>
:
EventBase
的子类,可以通过泛型来指定发布的信息类型。
常用成员
SubscriptionToken Subscribe(Action<TPayload> action)
:
PubSubEvent<TPayload>
的实例方法,传入有参的
Action
委托(事件执行方法),来订阅事件。
Publish(TPayload payload)
:
PubSubEvent<TPayload>
的实例方法,发布事件,
TPayload
发布的消息对象,要与创建事件类型时,继承
PubSubEvent<TPayload>
所指定的泛型类型一致。
Unsubscribe(Action<TPayload> subscriber)
:
PubSubEvent<TPayload>
的实例方法,取消订阅,只有在订阅时
keepSubscriberReferenceAlive
参数为
true
才需要调用,默认情况下是不需要的。
PubSubEvent
:
EventBase
的子类,可以定义无参事件。
常用成员
SubscriptionToken Subscribe(Action action)
:
PubSubEvent
的实例方法,传入无参
Action
委托(事件执行方法),来订阅事件。
Publish()
:
PubSubEvent
的实例方法,发布事件。
Unsubscribe(Action subscriber)
:
PubSubEvent
的实例方法,取消订阅,只有在订阅时keepSubscriberReferenceAlive参数为
true
才需要调用,默认情况下是不需要的。
3、完整实现
- 创建事件类型一般会在程序集中新建Events文件夹,将事件类型统一放在里面。如果仅仅是为了发布,而不需要携带任何信息,可以直接继承非范型的
PubSubEvent
即可。publicclassMessageEvent:PubSubEvent<string>{}
- ViewModel层中订阅、发布事件通过
IEventAggregator
的GetEvent<TEventType>()
注册或获取IOC容器中指定类型的事件对象。通过PubSubEvent<TPayload>
的Subscribe(Action<TPayload> action)
方法和Publish(TPayload payload)
方法进行事件的订阅与发布。publicclassMainWindowViewModel:BindableBase{privatestring _message;publicstring Message {get{return _message;}set{SetProperty(ref _message,value);}}privateIEventAggregator _eventAggregator;//构造函数方式的IOC依赖注入,注入事件聚合器对象publicMainWindowViewModel(IEventAggregator eventAggregator){ _eventAggregator = eventAggregator;//进行事件的注册及订阅 _eventAggregator.GetEvent<MessageEvent>().Subscribe(EventHandle);}privatevoidEventHandle(string msg){//事件的执行内容 Message = msg;}//定义命令来出发事件(发布)publicICommand BtnCommand {get=>newDelegateCommand(()=>{ _eventAggregator.GetEvent<MessageEvent>().Publish("this is my first prism message");});}}
- View层中绑定命令,触发事件发布
<Window ......><Grid><StackPanel><TextBlock Text="{Binding Message}"/><Button Content="Send message" Command="{Binding BtnCommand}"/></StackPanel></Grid></Window>
4、订阅的参数设置
在订阅时,可以通过
Subscribe
方法,进行以下设置。
设置执行线程
Subscribe(Action<TPayload> action, ThreadOption threadOption)
:threadOption用于设置action在哪种线程上调用,为
ThreadOption
枚举。
ThreadOption.PublisherThread
:在发布者的执行线程上执行action。ThreadOption.UIThread
:不管在哪个线程发布,action都在UI线程中执行。ThreadOption.BackgroundThread
:不管在哪个线程发布,action都在新建的后台线程中执行。
订阅卸载
Subscribe(Action<TPayload> action, bool keepSubscriberReferenceAlive)
:keepSubscriberReferenceAlive用于设置当窗口关闭时,是否保持订阅,默认为
false
,也就是当窗口关闭时就会取消action对该事件的订阅,下次打开窗口又重新订阅。设置为
true
时,则保持订阅,会增加一丢丢效率,注意设置为true后要主动调用
Unsubscribe
方法才可以取消订阅。一般使用默认的
false
就可以了。
消息过滤器
Subscribe(Action<TPayload> action, Predicate<TPayload> filter)
:filter用于对发送的消息进行过滤,返回
true
时顺利发送,否则拦截。filter是一个返回
bool
值的带参委托。
- 注意,无参事件无法设置消息过滤器。
_eventAggregator.GetEvent<MessageEvent>().Subscribe(EventHandle,(msg)=> msg.Contains("我想过滤啥就过滤啥"));
二、弹出窗口
在开发过程中,有些情况需要跨模块弹出窗口,接下来学习一下在View层以外的地方实现窗口的弹出。
1、简单实现
①、创建用户控件
跨模块的窗口弹出,只需要创建窗口的内容即可,也就是用户控件,这里是在Views文件夹下,创建DialogContentView用户控件。
需要注意的是,默认情况下,如果需要对弹出窗口进行样式设置的话,需要通过
prism:Dialog.WindowStyle
来进行设置。
- 具体代码
<UserControlx:Class="Zhaoxi.PrismDialog.Views.DialogContentView"xmlns:prism="http://prismlibrary.com/"......><prism:Dialog.WindowStyle><StyleTargetType="Window"> <Setter Property="Width" Value="500"/> <Setter Property="Height" Value="400"/> <!--设置WindowStyle方式的无边款--> <!--<Setter Property="WindowStyle" Value="None"/> <Setter Property="AllowsTransparency" Value="True"/>--> <!--设置WindowChrome的无边款--> <Setter Property="WindowChrome.WindowChrome"> <Setter.Value> <WindowChrome GlassFrameThickness="-1"/> </Setter.Value> </Setter> </Style></prism:Dialog.WindowStyle></UserControl>
②、创建ViewModel
在ViewModels文件夹中创建DialogContentViewModel类并实现
IDialogAware
接口。
- 具体代码
publicclassDialogContentViewModel:IDialogAware{publicstring Title =>"跨域弹出来的子窗口标题";//关闭弹窗的操作publiceventAction<IDialogResult> RequestClose;//是否允许关闭窗口publicboolCanCloseDialog(){//可以根据情况做一下业务判断returntrue;}//窗口关闭或主动触发RequestClose事件时调用publicvoidOnDialogClosed(){}//窗口打开时调用publicvoidOnDialogOpened(IDialogParameters parameters){}}
③、注册View
在App的
RegisterTypes
方法中通过调用
IContainerRegistry
对象的
RegisterDialog
方法进行DialogContentView的注册
RegisterDialog<TView>(string name = null)
:注册对话类型,可以传入
string
作为使用时的key。
- 需要注意的是,如果没有传入name参数,使用
ShowDialog
展示时,则根据注册的对话类型名称来查找。如果传入了name,则必须根据name来查找。 - 具体代码
publicpartialclassApp:PrismApplication{protectedoverrideWindowCreateShell(){return Container.Resolve<Views.MainWindow>();}protectedoverridevoidRegisterTypes(IContainerRegistry containerRegistry){//注册一个窗口类型 containerRegistry.RegisterDialog<Views.DialogContentView>();}}
④、定义弹出窗口命令
通过IOC依赖注入,获得
IDialogService
属性对象。
定义命令,在命令中调用
IDialogService
对象的
ShowDialog
方法来展示串口。
ShowDialog(string name)
:展示模态对话框,如果注册时,指定了对话名称,则根据名称在IOC的对话容器中查找。否则就根据对话类型的名称进行查找。至于对话的父类窗口,默认情况下会自动使用Prism内置的默认窗口对象。
Show(string name)
:的用法与ShowDialog(string name)
用法一样,只不过展示的是非模态对话框。- 具体代码
publicclassMainWindowViewModel:BindableBase{privatestring _btnContent ="跨域弹窗";publicstring BtnContent {get{return _btnContent;}set{SetProperty(ref _btnContent,value);}}//IOC依赖注入[Dependency]publicIDialogService _dialogService {get;set;}publicICommand BtnCommand {get=>newDelegateCommand(()=>{//展示窗口 _dialogService.ShowDialog("DialogContentView");});}}
⑤、主窗口中绑定命令
- 具体代码
<Window ......><Grid><StackPanel><Button Content="{Binding BtnContent}" Command="{Binding BtnCommand}"/></StackPanel></Grid></Window>
2、注册父类窗口
在上面的实现过程中,我们只创建了用户控件,而用户控件的父类容器,即弹出来的窗口对象则使用了Prism中默认的Dialog窗口。也因此,默认情况下,如果需要对弹出的窗口进行设置,要在用户控件中通过
prism:Dialog.WindowStyle
来进行默认窗口的样式设置。
然而通过
prism:Dialog.WindowStyle
来进行窗口的样式设置的做法本来就不是很符合xaml的设计规范,而且这只能对当前的用户控件起效果,如果有多个控件希望进行统一的窗口样式处理的话,在每个用户控件中都编写一样的代码会显得很冗余。较好的解决方案就是重新创建并设置好一个父类窗体,然后注册到IOC的对话窗口容器中。
成功为对话设置了父类窗口后,父类窗口的样式就可以跟平常的WPF窗口一样直接在XAML中进行设置了。其在XAML中设置的样式的优先级高于
prism:Dialog.WindowStyle
。
①、创建父类窗体
在程序集中新建DialogBase文件夹(文件夹名称并不重要,甚至可以不用创建)并在其中创建DialogWindowBase窗口。
在后台代码实现
IDialogWindow
,简化一下
Result
属性
- 具体代码xaml代码
<Window......WindowStartupLocation="CenterScreen"Background="Transparent"ResizeMode="NoResize"Title="DialogWindowBase"Height="300"Width="500"><WindowChrome.WindowChrome><WindowChromeGlassFrameThickness="-1"/></WindowChrome.WindowChrome><Grid></Grid></Window>
后台代码publicpartialclassDialogWindowBase:Window,IDialogWindow{publicDialogWindowBase(){InitializeComponent();}publicIDialogResult Result {get;set;}}
②、注册父类窗体类型
通过
RegisterDialogWindow
进行对话父类窗口类型的注册后,会优先使用,而不会自动使用默认的对话窗口类型对象。
RegisterDialogWindow<TWindow>([string name])
:注册对话的父类窗口类型。
- 当注册多个父类窗口类型时,可以传入name方便后面展示时通过key来指定窗口类型,需要注意注册时一旦指定了name,展示时就必须要指定name,否则找不到对应的父类窗口对象。
需要注意的是,要进行注册的对话父类窗口的后台代码中都必须实现
IDialogWindow
接口,否则无法注册。
- 具体代码
publicpartialclassApp:PrismApplication{protectedoverrideWindowCreateShell(){return Container.Resolve<Views.MainWindow>();}protectedoverridevoidRegisterTypes(IContainerRegistry containerRegistry){//注册一个对话类型 containerRegistry.RegisterDialog<DialogContentView>();//注册一个对话父类窗口类型 containerRegistry.RegisterDialogWindow<DialogWindowBase>();//还可以注册多个父类窗口类型,然后根据key来指定}}
③、展示窗口
通过IOC依赖注入,获得
IDialogService
属性对象。
定义命令,在命令中调用
IDialogService
对象的
ShowDialog
方法来展示串口。
- 当注册的对话父类窗口类型只有一个且没有指定名称时,prism会自动去使用,因此只要指定对话类型即可。
- 具体代码
publicclassMainWindowViewModel:BindableBase{......[Dependency]publicIDialogService _dialogService {get;set;}publicICommand BtnCommand {get=>newDelegateCommand(()=>{ _dialogService.ShowDialog("DialogContentView");});}}
3、指定父类窗体
当注册了多个父类窗体时,可以通过名称来区分。
①、注册多个父类窗口
- 具体代码
publicpartialclassApp:PrismApplication{protectedoverrideWindowCreateShell(){return Container.Resolve<Views.MainWindow>();}protectedoverridevoidRegisterTypes(IContainerRegistry containerRegistry){//注册一个对话类型 containerRegistry.RegisterDialog<DialogContentView>("DialogOne"); containerRegistry.RegisterDialog<DialogContentView>("DialogTwo");//这里为了方便就不再创建一个新的用户控件了//注册一个对话父类窗口类型 containerRegistry.RegisterDialogWindow<DialogWindowBase>("windowBase");//可以注册多个父类窗口类型,然后根据key来指定 containerRegistry.RegisterDialogWindow<DialogWindowOne>("windowOne");}}
②、指定展示
需要注意的是,如果注册的对话指定了名称,展示时没有使用匹配的名称会导致找不到而报异常;如果注册的窗体类型都指定了名称,展示时没有指定名称则会使用prism框架中默认的窗体类型。
- 具体代码
publicclassMainWindowViewModel:BindableBase{......[Dependency]publicIDialogService _dialogService {get;set;}publicICommand BtnCommand {get=>newDelegateCommand(()=>{//指定展示的对话及父类窗体 _dialogService.ShowDialog("DialogOne",null,null,"windowBase");});}}
4、数据传递
当需要向弹出窗体的内容(即我们创建的用户控件)传递一些数据的时候,可以通过
ShowDialog
方法来实现。
①、传递数据
ShowDialog(string name, IDialogParameters parameters, Action<IDialogResult> callback, string windowName)
:展示对话窗口。
- parameters:向对话窗口传递的数据对象。
DialogParameters
:
IDialogParameters
的子类,用法跟字典是一样的,可以用
DialogParameters
对象封装数据后传递给对话窗口。
- 具体代码
publicclassMainWindowViewModel:BindableBase{......[Dependency]publicIDialogService _dialogService {get;set;}publicICommand BtnCommand {get=>newDelegateCommand(()=>{//创建数据载体var dialogParameters =newDialogParameters(); dialogParameters.Add("paramKey","paramValue");//展示窗口并进行数据传递 _dialogService.ShowDialog("DialogOne", dialogParameters,null,"windowBase");});}}
②、数据处理
传递的数据对象会在窗口打开时,传递给对应的
IDialogAware
子类对象(一般就是弹出窗口的ViewModel)的
OnDialogOpened
方法。因此,可以在
OnDialogOpened
方法中对数据进行处理。
- 具体代码
publicclassDialogContentViewModel:BindableBase,IDialogAware{......publicvoidOnDialogOpened(IDialogParameters parameters){ PassValue = parameters.GetValue<string>("paramKey");}privatestring _passValue;publicstring PassValue {get{return _passValue;}set{SetProperty(ref _passValue,value);}}}
5、回调函数
当弹出的窗口关闭时需要执行回调函数,也是通过
ShowDialog
方法来实现的。
①、设置回调函数
ShowDialog(string name, IDialogParameters parameters, Action<IDialogResult> callback, string windowName)
:展示对话窗口。
- callback:对话窗口的回调函数,为一个接收
IDialogResult
类型参数的Action
对象。设置后会自动挂载到对应的IDialogAware
子类对象(一般就是弹出窗口的ViewModel)RequestClose
事件上,也就是可以通过RequestClose
事件来调用callback回调函数。 - 需要注意的是
RequestClose
事件的触发,会先调用窗口的关闭函数,再执行回调函数。对话窗口的正常关闭也会执行回调函数。 - 具体代码
publicclassMainWindowViewModel:BindableBase{......[Dependency]publicIDialogService _dialogService {get;set;}publicICommand BtnCommand {get=>newDelegateCommand(()=>{var dialogParameters =newDialogParameters(); dialogParameters.Add("paramKey","paramValue"); _dialogService.ShowDialog("DialogOne", dialogParameters, DialogCallBack,"windowBase");});}//对话窗口的回调函数privatevoidDialogCallBack(IDialogResult result){//可以根据传过来的result做业务逻辑处理}}
②、调用回调函数
在对应的ViewModel上定义命令,触发
RequestClose
事件。
- 具体代码
publicclassDialogContentViewModel:BindableBase,IDialogAware{......publiceventAction<IDialogResult> RequestClose;publicICommand CallBackCommand {get=>newDelegateCommand(()=>{DialogResult dialogResult =newDialogResult(ButtonResult.OK); RequestClose?.Invoke(dialogResult);});}}
版权归原作者 SchuylerEX 所有, 如有侵权,请联系我们删除。