VisualState.Name Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Dient zum Abrufen oder Festlegen des Namens der 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

Eigenschaftswert

String

Der Name des VisualState.

Beispiele

Im folgenden Beispiel wird eine VisualStateGroup im ControlTemplate eines Button namens CommonStates erstellt und VisualState Objekte für die Zustände, Normal, Pressedund MouseOverhinzugefügt. Die Button definiert auch einen Zustand namens Disabled, der sich im CommonStatesVisualStateGroupbefindet, aber im Beispiel wird er aus Platzgründen weggelassen. Das gesamte Beispiel finden Sie unter Anpassen der Darstellung eines vorhandenen Steuerelements durch Erstellen einer 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>

Hinweise

Sie geben an, welchen visuellen Zustand ein Element eingeben soll, indem Sie die Name des VisualState an die VisualStateManagerübergeben.

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

Informationen zum Suchen der Namen der visuellen Zustände für die Steuerelemente, die in WPF enthalten sind, finden Sie unter Steuerelementformatvorlagen und -vorlagen. Informationen zum Erstellen eines ControlTemplate- und VisualState-Objekts für vorhandene Steuerelemente finden Sie unter Anpassen der Darstellung eines vorhandenen Steuerelements durch Erstellen einer ControlTemplate-.