顾名思义,触发器(Trigger)就是当某种条件满足后即完成相应逻辑功能的一部分程序组成。在当前的WPF中,Trigger一共有三种类型,它们分别是:
在WPF中,每一个可以使用触发器的类中都会有一个Triggers属性。拥有这个属性的类有:FrameworkElement,Style,DataTemplate和ControlTemplate。但是需要注意的是,FrameworkElement类只支持EventTrigger。这是因为微软还没有完成它对其他两类触发器的支持。如果程序中需要使用属性触发器或数据触发器的功能,软件开发人员就需要使用设置样式触发器的方法对触发器进行一次包装,再将该样式应用在FrameworkElement类的实例上。因此就现在来说,Trigger和EventTrigger仅可以用在控件模板或样式中,而DataTrigger则只能用在数据模板之中。本书对样式以及模板的介绍将在本章的稍后部分进行。因此在这里所讲解的对触发器的应用仅限于对Trigger元素的直接使用,而并不涉及其他复杂的使用。
同时,为了支持对复杂触发条件的表示,WPF还引入了MultiTrigger和MultiDataTrigger完成对与逻辑的支持。如果想用触发器表示或逻辑,软件开发人员可以通过将多个触发器同时放置到Triggers属性中完成。
1.触发器使用准则
不论是上面的哪种触发器,都不能脱离WPF对用户界面进行定义的三个准则。而这三个准则不仅导致触发器成为了WPF的一部分,更重要的是,还完成了对触发器使用规范的定义。
(1)元素合成
经过对前面几章知识的学习,相信读者已经习惯了使用多个界面元素定义一个具有特定功能的控件。例如在3.2节中,就通过将一个图像放置在按钮控件中完成了对位图按钮的定义。由于Image类是FrameworkElement类的派生类,可以接受用户输入,因此当鼠标位于Image上方并按下鼠标左键的时候,鼠标左键被按下的消息不仅由Button类实例接收到,更重要的是,Image类实例也接收到这个消息,并且是由该实例将这个消息,传送到Button类实例中的。这个由元素合成所导致的现象也将触发源定义的灵活性引入到了触发器的使用中。即对于此例,软件开发人员不仅可以将触发器的触发源定义为Image类实例,更可以定义为Button类实例。将触发源定义为Button类实例的好处是:软件在处理Button类实例的鼠标左键消息的同时也就处理了Image类实例的鼠标左键消息。
元素合成对触发器使用的影响不仅如此。实际上WPF中的各个控件都是由其他界面元素组成的,比如组成按钮控件的Border,ButtonChrome等。那么在使用XAML定义一个控件的外观,也就是该控件的ControlTemplate的时候,软件开发人员就需要考虑触发器消息源的位置。
(2)界面与行为分离
或许用户还没有体会到,WPF的另一个特点就是让用户界面定义与软件的业务逻辑分离。也就是说,在程序员编写软件的业务逻辑的时候,用户界面设计师同时可以将软件所需的界面通过XAML描述出来。
假如软件开发人员正在编写一个用户注册系统,该系统要求用户输入自己的用户名并重复输入两次密码完成对该用户名的注册。而且该系统的主要特色就是当用户重复输入密码发生错误的时候,第二个密码输入框的边框将显示为红色。以当前所介绍的知识来看,软件开发人员需要使用一个函数侦听TextBox的TextChanged消息。在两个密码框中的字符并不是包含关系的时候,该消息的处理函数会将第二个消息框的边框设置为红色。也就是说,在了解触发器之前,该功能需要在C#代码中实现。
实际上,这只是一个界面上的功能,而与后台程序的业务逻辑完全没有关系。因此软件开发人员需要在XAML中使用一种方法完成该功能。这个方法就是使用触发器。
(3)选择合适的触发条件
在WPF中,用户可以发现许多貌似重复的事件以及函数。比如IInputElement接口已经实现了表示鼠标左键点击的MouseLeftButtonDown事件,而在ButtonBase类中WPF又为相同行为添加了Click事件。该事件不仅表示点击鼠标左键导致的按钮被按下这一行为,也表示默认按钮在用户按下回车键时被按下或当前具有输入焦点的按钮在用户按下空格键时被按下这一行为。另外一个例子是TextBox类不仅有GotFocus这一事件,更有GotKeyboardFocus,GotStylusCapture和GotMouseCapture等事件。也就是说,Click事件以及GotFocus事件都是具有更强大功能的事件,而且可以预计的是,各种WPF控件中还有许多这样的类似情况。因此在XAML中定义触发器的时候,软件开发人员一定要考虑清楚触发器的实际触发条件。
2.触发器相关知识
在系统地介绍各个触发器之前,请读者先来看看与触发器相关的知识。本节所介绍的知识包括触发器基类TriggerBase类的继承结构,以及Setter类的使用。
(1)TriggerBase类的继承结构
首先,本书还是从各个触发器的基类的继承结构开始讲解。下图是TriggerBase类的继承结构。
可以看到,TriggerBase类是一个虚基类。该类直接派生自DependencyObject类,并只引入了两个新的属性:EnterActions和ExitActions。这两个属性分别表示所侦听的属性触发当前触发器时以及离开触发状态时所要执行的动作。但是,由于EventTrigger表示发生事件的一个时间点,而并不是保持在某一种状态的一段时间,所以EventTrigger并不支持对该属性的使用。为了赋予EventTrigger相同的功能,WPF为它添加了Actions属性。对该属性的介绍将安排到讲解事件触发器时。为了使读者更清楚地了解EnterActions和ExitActions属性的使用,下面列出了一个使用这两个属性的例子:
<trigger Property="IsMouseOver" Value="True"> </trigger><trigger .EnterActions> <beginstoryboard> <storyboard> <doubleanimation Storyboard.TargetProperty="Opacity" To="1" Duration="0:0:1"></doubleanimation> </storyboard> </beginstoryboard> </trigger> <trigger .ExitActions> <beginstoryboard> <storyboard> <doubleanimation Storyboard.TargetProperty="Opacity" To="0.25" Duration="0:0:1"></doubleanimation> </storyboard> </beginstoryboard> </trigger>
在以上代码中,Trigger类作为TriggerBase类的直接派生类被使用。Trigger类中新引入了四个属性,按照逻辑关系,它们是SourceName,Property,Value和Setters。当需要定义一个触发器时,软件开发人员需要使用SourceName定义触发器事件的起源。在触发条件与拥有该触发器的界面元素没有关系的情况下,该属性用来对触发器事件的起源进行指向。在确定了触发器事件的起源后,XAML代码就可以设定该触发器需要侦听的属性和需要比较的值。当属性中记录的值与比较值相同时,WPF就需要执行Setters中记录的各个Setter,完成触发器的控制功能。
(2)Setter类的使用
Setter类是非常容易使用的。它具有三个常用的属性:TargetName,Property和Value。这三个属性分别表示需要设置属性所在实例的名称、需要进行设置的属性和需要将该属性设置的值。但需要注意的是,被设置的属性必须是关联属性。当Trigger或Style中设置了TargetType的时候,XAML可以直接指定需要设置的属性而省略对象的类型。但在没有指定TargetType的情况下,Setter中对TargetType类型的Property属性的设置就必须使用TargetType.Property的形式。例如,当需要使用Setter元素设置按钮控件的背景颜色为蓝色时,软件开发人员就可以使用下面的XAML语句:
<setter Property="Button.Background" Value="Blue"></setter>
从MSDN对Setter类的基类SetterBase的介绍中可以看到,Setter类的基类SetterBase不只有一个派生类。除了Setter类之外,SetterBase类的派生类还有一个EventSetter类。EventSetter类用来完成对事件处理函数的定义。例如,若想让一个Button类实例在鼠标移动到其上时运行OnMouseEnter函数,软件开发人员就可以使用下面的代码:
<eventsetter Event="Button.MouseEnter" Handler="OnMouseEnter"></eventsetter>
但是从WPF将用户界面定义与逻辑代码分离的设计思想来看,EventSetter无疑是一个不太友好的设计。而且在不同地方使用不同的EventSetter的情况下,软件开发人员并没有一个好的办法判断各个事件处理函数被执行的先后次序。而在一个以事件作为驱动的程序中,无法对事件响应函数的执行顺序进行控制无疑是一件最危险的事情。
3.属性触发器
首先来看看属性触发器。属性触发器在指定的属性具有指定的值时,执行它所包含的一系列Setter完成对其他属性的设置。而当该属性不再是该指定值时,所有的属性设置将被恢复到前一状态。
以下代码就是一个使用触发器的例子。
<textbox TextWrapping="Wrap" Margin="5"> </textbox><textbox .Style> <style TargetType="TextBox"> </style><style .Triggers> <trigger Property="Text" Value="text"> <setter Property="Background" Value="Aqua"></setter> </trigger> </style> </textbox>
在包含上例代码的程序中,如果用户在文本输入框中输入”text”,输入框的背景颜色将变成绿色。完成这种控制逻辑的就是在Style中定义的属性触发器Trigger。在Trigger的声明中,对Trigger各属性的设置声明了Trigger被触发的条件:当Text属性为字符串”text”的时候,执行Setter中对属性的设置,即将背景颜色变成绿色。
4.数据触发器
除了Trigger类可以用来侦听属性的变化外,软件开发人员还可以使用DataTrigger完成对任意类型的CLR数据变化的侦听。因此,DataTrigger类不仅可以完成Trigger类的所有功能,更可以运行非关联属性的更改触发逻辑。DataTrigger类一共引入了三个参数:Binding,Value和Setters。当需要设置数据触发器侦听的数据源时,软件开发人员应该以通过绑定对Binding属性赋值的方式来完成。即如果需要使用DataTrigger完成上面对TextBox背景颜色进行更改的功能,软件开发人员就需要使用以下代码:
<textbox TextWrapping="Wrap" Margin="5"> </textbox><textbox .Style> <style TargetType="TextBox"> </style><style .Triggers> <datatrigger Binding="{Binding RelativeSource={RelativeSource Self}, Path=Text}" Value="text"> <setter Property="Background" Value="Aqua"></setter> </datatrigger> </style> </textbox>
需要注意的是:虽然软件开发人员可以使用DataTrigger完成对任意CLR类型数据变化的侦听,但Setter只能对关联属性进行设置。并且XAML不能在Setter中对Style属性进行更改。其原因是:触发器可以在样式中进行定义。当一个在样式中定义的触发器更改了其所在实例的样式时,WPF怎么继续处理触发器中剩余的设置?为了避免这个问题,WPF禁止在触发器中对样式进行设置。
5.事件触发器
WPF中还提供另一种触发器。该触发器的触发条件就是一个事件的发生。该触发器所对应的类为EventTrigger,即事件触发器。该类从TriggerBase类派生后只添加了三个属性:Actions,RoutedEvent和SourceName。软件开发人员可以通过SourceName属性指定激活该触发器的元素名称。而RoutedEvent属性则记录激活该触发器的事件。Actions是一个只读属性,表示触发器被触发时需要执行的动作。
6.或逻辑触发器
当需要表示或逻辑关系时,软件开发人员可以简单地将多个触发器并列。当某一个触发器所标识的条件满足时,该触发器所包含的行为将执行,导致使用这个触发器的用户界面元素实例的属性改变。如果在前面的例子中,软件设计师不仅希望TextBox 的背景颜色在用户输入为”text”时为绿,也希望背景在用户输入为”text.”时为绿,那么对该要求的实现逻辑用XAML语句见以下代码:
<textbox TextWrapping="Wrap" Margin="5"> </textbox><textbox .Style> <style TargetType="TextBox"> </style><style .Triggers> <datatrigger Binding="{Binding RelativeSource={RelativeSource Self}, Path=Text}"Value="text"> <setter Property="Background" Value="Red"></setter> </datatrigger> <datatrigger Binding="{Binding RelativeSource={RelativeSource Self}, Path=Text}" Value="text."> <setter Property="Background" Value="Blue"></setter> </datatrigger> </style> </textbox>
在或逻辑关系中,触发器的各属性匹配可能在同一时间被满足。在这种情况下,触发器对状态的设置同时生效。在各个触发器对属性的设置发生冲突时,WPF将按照后声明的触发器所制定的规则对属性进行设置。可参考对于以下代码中的触发器定义:
<button Content="Press Me!"> </button><button .Style> <style TargetType="{x:Type Button}"> </style><style .Triggers> <trigger Property="Button.IsMouseOver" Value="True"> <setter Property="Button.Foreground" Value="Blue"></setter> </trigger> <trigger Property="Button.IsPressed" Value="True"> <setter Property="Button.Foreground" Value="Red"></setter> </trigger> </style> </button>
当用户将鼠标移动到按钮上面并使用左键对按钮进行点击的时候,按钮的颜色将是红色,而不是蓝色。因为在按钮被按下之前,IsMouseOver属性的值为True,而在按钮被按下时IsPressed属性的值也变为True,所以按照后声明优先的决定方式,WPF将设置该按钮的背景颜色为红色。
7.与逻辑触发器
如果要表示与逻辑关系,软件开发人员就需要使用MutiTrigger或MutiDataTrigger。在使用这两种触发器时,软件开发人员需要向它们的Conditions集合中添加触发条件。假设软件需要下面一种功能:当TextBox中所记录的字符串是”text”并且鼠标在TextBox之上时,TextBox的背景颜色将变成绿色。完成该功能的XAML语句如以下示例代码所示。
<textbox Margin="5" TextWrapping="Wrap"> </textbox><textbox .Style> <style TargetType="TextBox"> </style><style .Triggers> <multitrigger> </multitrigger><multitrigger .Conditions> <condition Property="Text" Value="text"></condition> <condition Property="IsMouseOver" Value="True"></condition> </multitrigger> <setter Property="Background" Value="Aqua"></setter> </style> </textbox>