首页 > 代码库 > VisualStateManager

VisualStateManager

VisualStateManager带来了什么?

在WPF中我们可以用各种Trigger配合Animation,Template来实现绚丽控件的外观变换,用后台逻辑来定义和标注控件不同的状态。.Net Framework 4.o开始引入了VisualStateManager,主要为了控制控件的状态转换,和其间涉及的外观行为。从控件状态迁移层面上管理空间的外观行为,在设计级别上感觉层次更清晰,边界更明确。VisualStateManager用途: 1. 管理控件状态。 2. 管理控件状态的转换逻辑。

 

我们通过VisualStateManager控件的状态、控件在特定状态下以及控件更改状态时的外观。更清晰的表述我们看下MSDN原文: The VisualStateManager enables you to specify: 1. states for a control 2. the appearance of a control when it is in a certain state. 3. the appearance of a control when a control changes states.

 

VisualStateManager相关类

VisualStateManager常用类的相关结构,是比较典型的层层深入的包含结构,我们这里说明一些每一个层次的作用: 1. 通过在控件上设置VisualStateManager.VisualStateGroups附加属性向控件添加可视状态。 2. VisualStateGroups包含VisualStateGroup对象集合。 3. VisualStateGroup包含互斥的VisualState对象的集合。 在每个VisualStateGroup中,控件都始终恰好处于一个状态。 4. VisualState用于定义控件状态,和处于某个状态时的外观。 5. VisualState 包含Storyboard对象的集合,用于指定控件处于该状态时如何更改控件的外观。

下面的XAML更直观形象:

    <VisualStateManager.VisualStateGroups>         <VisualStateGroup x:Name="XXX">             <VisualState x:Name="State001">                 <Storyboard>                     <Animation_A1 .../>                     <Animation_B1 .../>                     ...                 </Storyboard>             </VisualState>             <VisualState x:Name="State001">                 <Storyboard>                     <Animation_A2 .../>                     <Animation_B2 .../>                     ...                 </Storyboard>             </VisualState>             ...         </VisualStateGroup>         ...     </VisualStateManager.VisualStateGroups>

 

我们这边给出一个实际定义VisualStateManager.VisualStateGroups的例子,在Windows Resource中定义一个Button Template,随着鼠标的Enter和Leave标识两种状态,根据不同的状态来显示不同的外观:rectangle或ellipse。

    <Window.Resources>         <ControlTemplate x:Key="ButtonColorChangeStyleTemplate" TargetType="{x:Type Button}">             <Grid x:Name="LayoutRoot" Background="Transparent" MouseEnter="ShapeChangeMouseEvent" MouseLeave="ShapeChangeMouseEvent">                 <VisualStateManager.VisualStateGroups>                     <VisualStateGroup x:Name="Layout">                         <VisualState x:Name="EllipseState">                             <Storyboard>                                 <DoubleAnimation Duration="0:0:1" To="1" Storyboard.TargetProperty="(UIElement.Opacity)" Storyboard.TargetName="ellipse" />                                 <DoubleAnimation Duration="0:0:1" To="0" Storyboard.TargetProperty="(UIElement.Opacity)" Storyboard.TargetName="rectangle" />                             </Storyboard>                         </VisualState>                         <VisualState x:Name="RectangleState">                             <Storyboard>                                 <DoubleAnimation Duration="0:0:1" To="0" Storyboard.TargetProperty="(UIElement.Opacity)" Storyboard.TargetName="ellipse" />                                 <DoubleAnimation Duration="0:0:1"  To="1" Storyboard.TargetProperty="(UIElement.Opacity)" Storyboard.TargetName="rectangle"/>                             </Storyboard>                         </VisualState>                     </VisualStateGroup>                 </VisualStateManager.VisualStateGroups>                 <Rectangle x:Name="rectangle" Fill="Blue" Height="90" Margin="2,2,2,2" Opacity="0" Stroke="Black" VerticalAlignment="Top"/>                 <Ellipse x:Name="ellipse" Fill="Orange"  Height="90" Margin="2,2,2,2" Opacity="1" Stroke="Black" VerticalAlignment="Top"/>             </Grid>         </ControlTemplate>     </Window.Resources>

上面是一个在ControlTemplate中定义VisualStateManager.VisualStateGroups的例子,在应用程序中,控件之外定义也非常类似,下面的例子,在一个Button上随着鼠标的Enter和Leave定义两种状态,根据不同的状态来显示不同颜色:Orange或Blue。

    <Grid>         <Button Template="{StaticResource ButtonColorChangeStyleTemplate}" Content="Button"                 HorizontalAlignment="Left" Margin="39,17,0,0" Name="button1" VerticalAlignment="Top" Width="104" Height="95" />         <Button Name="button2" MouseEnter="ColorChangeMouseEvent" MouseLeave="ColorChangeMouseEvent" Margin="198,17,0,0" Height="88" VerticalAlignment="Top" HorizontalAlignment="Left" Width="100">             <VisualStateManager.VisualStateGroups>                 <VisualStateGroup Name="MouseStates">                     <VisualState Name="BlueState">                         <Storyboard>                             <ColorAnimation To="Blue" Storyboard.TargetName="rectBrush" Storyboard.TargetProperty="Color"/>                         </Storyboard>                     </VisualState>                     <VisualState Name="OrangeState">                         <Storyboard>                             <ColorAnimation To="Orange" Storyboard.TargetName="rectBrush" Storyboard.TargetProperty="Color"/>                         </Storyboard>                     </VisualState>                 </VisualStateGroup>             </VisualStateManager.VisualStateGroups>             <Button.Background>                 <SolidColorBrush x:Name="rectBrush" Color="Orange"/>             </Button.Background>         </Button>     </Grid>

 

状态迁移方法GoToState,GoToElementState

分别在ControlTemplate和应用程序中定义好了状态,我们来看一下状态迁移的方法:

1. GoToState, 用于转换定义在控件自身内部定义的状态(比较常见的标志就是状态定义在控件的ControlTemplate中)。 2. GoToElementState,用于转换由应用程序(而非控件自身)定义的状态。

 

对于这两种方法,VisualStateManager都执行相应逻辑,启动和停止与有关状态相关的StoryBoards,该逻辑是定义在默认的VisualStateManager的GoToStateCore方法中的,默认逻辑流程如下以GoToState为例(我们用旧State,新State表示状态的迁移,方便描述): 1. 如果控件要转换到的新State有Storyboard,运行该Storyboard。如果控件的旧State有Storyboard,结束其运行。 2. 如果控件已处于新state状态(即新旧State相同),则GoToState不执行任何操作并返回true。 3. 如果新State在控件的ControlTemplate中不存在(因为是以GoToState为例,所以会去找ControlTemplate中的状态),则GoToState不执行任何操作并返回 false。

 

有了上面状态的定义,我们在C# Code中加入状态迁移的逻辑,演示GoToState,GoToElementState的用法。

        private void ShapeChangeMouseEvent(object sender, MouseEventArgs e)         {             if (button1.IsMouseOver)             {                 bool result = VisualStateManager.GoToState(button1, "RectangleState", true);             }             else             {                 VisualStateManager.GoToState(button1, "EllipseState", true);             }         }
private void ColorChangeMouseEvent(object sender, MouseEventArgs e) { if (button2.IsMouseOver) { VisualStateManager.GoToElementState(button2, "BlueState", true); } else { VisualStateManager.GoToElementState(button2, "OrangeState", true); } }

程序运行结果:Button会根据鼠标的Enter和Leave改变形状和颜色。

提示1:注意分清GoToState,GoToElementState的使用场合。 提示2:当状态被成功改变时,方法返回true,否则false。要好好的应用这几个方法的返回值,因为一般情况下状态迁移的多没有明显的Exception抛出,更多的是storyboard没有被执行,UI没有任何反映,默默的出错(汗...)。应用返回值,可以得到状态是否成功迁移,有利于判断是我们storyboard逻辑问题,还是状态迁移问题等等。 提示3:如果需要和默认流程不一样的状态转换逻辑流程,我们可以继承VisualStateManager实现我们自己的VisualStateManager,并且重写 GoToStateCore方法。

VisualStateManager