VisualState.Name 属性

定义

命名空间:

System.Windows

程序集:

PresentationFramework.dll

获取或设置 VisualState的名称。

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

public string Name { get; set; }

member this.Name : string with get, set

Public Property Name As String

属性值

String

VisualState的名称。

示例

以下示例在名为 CommonStates 的 Button 的 ControlTemplate 中创建 VisualStateGroup，并为状态、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 的 Name 传递给 VisualStateManager来指定元素应输入的视觉状态。

当 Control 在 ControlTemplate中使用 VisualStateManager 时，控件作者应通过在类签名上放置 TemplateVisualStateAttribute 来指定控件期望在其 ControlTemplate 中找到哪些 VisualState 对象。 ControlTemplate 作者定义新的 VisualState 对象，并将 Name 属性设置为由 TemplateVisualStateAttribute.Name 属性指定的值。

若要查找 WPF 附带的控件的视觉状态的名称，请参阅 控件样式和模板。 有关如何为现有控件创建 ControlTemplate 和 VisualState 对象的信息，请参阅 通过创建 ControlTemplate自定义现有控件的外观。