VisualState 类

定义

public ref class VisualState : System::Windows::DependencyObject

[System.Windows.Markup.ContentProperty("Storyboard")]
[System.Windows.Markup.RuntimeNameProperty("Name")]
public class VisualState : System.Windows.DependencyObject

[<System.Windows.Markup.ContentProperty("Storyboard")>]
[<System.Windows.Markup.RuntimeNameProperty("Name")>]
type VisualState = class
    inherit DependencyObject

Public Class VisualState
Inherits DependencyObject

继承

Object

DispatcherObject

DependencyObject

VisualState

属性

ContentPropertyAttribute RuntimeNamePropertyAttribute

示例

以下示例VisualStateGroup在 名为 CommonStates 的 Button 中创建 ControlTemplate ，并为状态 Normal、 Pressed和 MouseOver添加 VisualState 对象。 还 Button 定义了一个名为 Disabled 的状态，该状态位于 中 CommonStatesVisualStateGroup，但为了简洁起见，本示例省略了它。 有关整个示例，请参阅 通过创建 ControlTemplate 自定义现有控件的外观。

  <!--Define the states and transitions for the common states.
      The states in the VisualStateGroup are mutually exclusive to
      each other.-->
  <VisualStateGroup x:Name="CommonStates">

    <!--The Normal state is the state the button is in
        when it is not in another state from this VisualStateGroup.-->
    <VisualState x:Name="Normal" />

    <!--Change the SolidColorBrush, BorderBrush, to red when the
        mouse is over the button.-->
    <VisualState x:Name="MouseOver">
      <Storyboard>
        <ColorAnimation Storyboard.TargetName="BorderBrush" 
                        Storyboard.TargetProperty="Color" 
                        To="Red" />
      </Storyboard>
    </VisualState>

    <!--Change the SolidColorBrush, BorderBrush, to Transparent when the
        button is pressed.-->
    <VisualState x:Name="Pressed">
      <Storyboard>
        <ColorAnimation Storyboard.TargetName="BorderBrush" 
                        Storyboard.TargetProperty="Color"
                        To="Transparent"/>
      </Storyboard>
    </VisualState>

    <!--The Disabled state is omitted for brevity.-->
  </VisualStateGroup>
</VisualStateManager.VisualStateGroups>

注解

指定 VisualState 控件处于特定状态时的外观。 例如，按下 时 Button ，其边框的颜色可能与正常颜色不同。 类 VisualState 具有更改 Storyboard 控件外观的属性。 当控件进入 由 VisualState.Name 属性指定的状态时， Storyboard 开始。 当控件退出状态时，将 Storyboard 停止。

属性 VisualStateGroup.States 包含 VisualState 对象。 VisualStateGroup 对象将添加到 VisualStateManager.VisualStateGroups 附加属性中，该属性在 上的 FrameworkElement上定义。 可以将 对象添加到VisualState任何 FrameworkElement，但它们通常用于 的 Control。ControlTemplate 有关如何为现有控件创建 ControlTemplate 和 VisualState 对象的信息，请参阅 通过创建 ControlTemplate 自定义现有控件的外观。 有关在 外部ControlTemplate使用 VisualState 对象的示例，VisualStateManager请参阅 类。

构造函数

属性

方法

适用于