VisualState.Name Proprietà

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Ottiene o imposta il nome del 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

Valore della proprietà

String

Nome del VisualState.

Esempio

Nell'esempio seguente viene creato un VisualStateGroup nella ControlTemplate di una Button denominata CommonStates e vengono aggiunti oggetti VisualState per gli stati, Normal, Pressede MouseOver. Il Button definisce anche uno stato denominato Disabled che si trova nel CommonStatesVisualStateGroup, ma l'esempio lo omette per brevità. Per l'intero esempio, vedere Personalizzazione dell'aspetto di un controllo esistente creando un oggetto 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>

Commenti

Specificare quale stato di visualizzazione deve immettere un elemento passando il Name del VisualState al VisualStateManager.

Quando un Control utilizza il VisualStateManager in un ControlTemplate, l'autore del controllo deve specificare quali oggetti VisualState il controllo prevede di trovare nel relativo ControlTemplate inserendo il TemplateVisualStateAttribute sulla firma della classe. ControlTemplate autori definiscono nuovi oggetti VisualState e impostano la proprietà Name sul valore specificato dalla proprietà TemplateVisualStateAttribute.Name.

Per trovare i nomi degli stati di visualizzazione per i controlli inclusi in WPF, vedere Modelli e stili di controllo. Per informazioni su come creare un ControlTemplate e oggetti VisualState per i controlli esistenti, vedere Personalizzazione dell'aspetto di un controllo esistente mediante la creazione di un controllo ControlTemplate.