VisualState.Name Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Ruft den Namen der VisualState ab oder legt diesen fest.

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

Eigenschaftswert

String

Der Name von VisualState.

Beispiele

Im folgenden Beispiel wird ein VisualStateGroup In der ControlTemplate Button aufgerufenen CommonStates und hinzugefügten VisualState Objekte für die Zustände, Normal, Pressed, und MouseOver. Außerdem Button wird ein Zustand definiert Disabled , der sich im CommonStates VisualStateGroupNamen befindet, aber das Beispiel überlässt ihn für Die Kürze. Das gesamte Beispiel finden Sie unter Anpassen der Darstellung eines vorhandenen Steuerelements durch Erstellen einer Steuerelementvorlage.

  <!--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>

Hinweise

Sie geben an, welchen visuellen Zustand ein Element eingeben soll, indem Sie den Name VisualState Wert an das VisualStateManagerElement übergeben.

Wenn ein Control Steuerelement in einem ControlTemplateObjekt verwendet VisualStateManager wird, sollte der Steuerelementautor angeben, welche VisualState Objekte das Steuerelement in seinem ControlTemplate Objekt finden soll, indem er die TemplateVisualStateAttribute Klassensignatur eingibt. ControlTemplate Autoren definieren neue VisualState Objekte und legen die Name Eigenschaft auf den von der TemplateVisualStateAttribute.Name Eigenschaft angegebenen Wert fest.

Um die Namen der visuellen Zustände für die Steuerelemente zu finden, die in WPF enthalten sind, finden Sie unter Steuerelementformatvorlagen und Vorlagen. Informationen zum Erstellen einer ControlTemplate und VisualState Objekte für vorhandene Steuerelemente finden Sie unter Anpassen der Darstellung eines vorhandenen Steuerelements durch Erstellen einer Steuerelementvorlage.