VisualState.Name Vlastnost

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Získá nebo nastaví název 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

Hodnota vlastnosti

String

Název VisualState.

Příklady

Následující příklad vytvoří VisualStateGroup v ControlTemplateButton s názvem CommonStates a přidá VisualState objekty pro stavy, Normal, Presseda MouseOver. Button také definuje stav s názvem Disabled, který je v CommonStatesVisualStateGroup, ale příklad ho vynechá pro stručnost. Celý příklad najdete v tématu Přizpůsobení vzhledu existujícího ovládacího prvku vytvořením ovládacího prvku 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>

Poznámky

Určíte, který vizuální stav má prvek zadat předáním NameVisualState do VisualStateManager.

Když Control použije VisualStateManager v ControlTemplate, autor ovládacího prvku by měl určit, který VisualState objekty, které ovládací prvek očekává, že bude nalezen v jeho ControlTemplate tak, že umístí TemplateVisualStateAttribute do podpisu třídy. ControlTemplate autoři definují nové objekty VisualState a nastavují vlastnost Name na hodnotu určenou vlastností TemplateVisualStateAttribute.Name.

Názvy stavů vizuálů pro ovládací prvky, které jsou součástí WPF, najdete v tématu styly ovládacích prvků a šablony. Informace o tom, jak vytvořit ControlTemplate a VisualState objekty pro existující ovládací prvky, naleznete v tématu Přizpůsobení vzhledu existujícího ovládacího prvku vytvořením controlTemplate.