VisualState 类

定义

命名空间:

System.Windows

程序集:

PresentationFramework.dll

表示控件处于特定状态时的视觉外观。

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

示例

以下示例在已调用的集合中创建一个VisualStateGroupButton，并添加VisualState状态、NormalPressed和MouseOver对象的对象。ControlTemplateCommonStates 该示例还定义了一个称为<a0/>的状态，但该示例为简洁起见省略该状态。 有关整个示例，请参阅 如何为控件创建模板。

  <!--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对象，但它们通常用于某个ControlTemplateControl对象。 有关如何为现有控件创建 ControlTemplate 对象的信息 VisualState ，请参阅 如何为控件创建模板。 有关在外部ControlTemplate使用VisualState对象的示例，请参阅该VisualStateManager类。

构造函数

名称	说明
VisualState()	初始化 VisualState 类的新实例。

属性

名称	说明
DependencyObjectType	获取包装 DependencyObjectType 此实例的 CLR 类型。 (继承自 DependencyObject)
Dispatcher	获取与此DispatcherDispatcherObject关联的值。 (继承自 DispatcherObject)
IsSealed	获取一个值，该值指示此实例当前是否密封（只读）。 (继承自 DependencyObject)
Name	获取或设置 . 的名称 VisualState。
Storyboard	获取或设置一个值， Storyboard 该值定义控件处于由该 VisualState控件表示的状态时的外观。

方法

名称	说明
CheckAccess()	确定调用线程是否有权访问此 DispatcherObject权限。 (继承自 DispatcherObject)
ClearValue(DependencyProperty)	清除属性的本地值。 要清除的属性由 DependencyProperty 标识符指定。 (继承自 DependencyObject)
ClearValue(DependencyPropertyKey)	清除只读属性的本地值。 要清除的属性由一个 DependencyPropertyKey. (继承自 DependencyObject)
CoerceValue(DependencyProperty)	强制指定依赖属性的值。 这是通过调用中调用依赖属性CoerceValueCallback的属性元数据中指定的任何DependencyObject函数来实现的。 (继承自 DependencyObject)
Equals(Object)	确定提供的 DependencyObject 是否等效于当前 DependencyObject。 (继承自 DependencyObject)
GetHashCode()	获取此 DependencyObject代码的哈希代码。 (继承自 DependencyObject)
GetLocalValueEnumerator()	创建一个专用枚举器，用于确定哪些依赖项属性具有本地 DependencyObject设置的值。 (继承自 DependencyObject)
GetValue(DependencyProperty)	返回此实例 DependencyObject上的依赖属性的当前有效值。 (继承自 DependencyObject)
InvalidateProperty(DependencyProperty)	重新评估指定依赖属性的有效值。 (继承自 DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	每当更新此 DependencyObject 属性上任何依赖属性的有效值时调用。 在事件数据中报告更改的特定依赖属性。 (继承自 DependencyObject)
ReadLocalValue(DependencyProperty)	返回依赖属性的本地值（如果存在）。 (继承自 DependencyObject)
SetCurrentValue(DependencyProperty, Object)	设置依赖项属性的值，而不更改其值源。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置依赖属性的本地值，由依赖属性标识符指定。 (继承自 DependencyObject)
SetValue(DependencyPropertyKey, Object)	设置只读依赖属性的本地值，由 DependencyPropertyKey 依赖属性的标识符指定。 (继承自 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	返回一个值，该值指示序列化进程是否应序列化所提供的依赖属性的值。 (继承自 DependencyObject)
VerifyAccess()	强制调用线程有权访问此 DispatcherObject权限。 (继承自 DispatcherObject)