VisualStateGroup Třída

Definice

public ref class VisualStateGroup : System::Windows::DependencyObject

[System.Windows.Markup.ContentProperty("States")]
[System.Windows.Markup.RuntimeNameProperty("Name")]
public class VisualStateGroup : System.Windows.DependencyObject

[<System.Windows.Markup.ContentProperty("States")>]
[<System.Windows.Markup.RuntimeNameProperty("Name")>]
type VisualStateGroup = class
    inherit DependencyObject

Public Class VisualStateGroup
Inherits DependencyObject

Dědičnost

Object

DispatcherObject

DependencyObject

VisualStateGroup

Atributy

ContentPropertyAttribute RuntimeNamePropertyAttribute

Příklady

Následující příklad vytvoří jednoduchý ControlTemplate objekt pro objekt Button , který obsahuje jeden Gridobjekt . Obsahuje také pojmenovanou VisualStateGroupCommonStates, která definuje MouseOver stavy a Normal . Má VisualStateGroup také parametr VisualTransition , který určuje, že změna ze zelené na červenou trvá půl sekundy Grid , když uživatel přesune ukazatel myši na Button.

<ControlTemplate TargetType="Button">
  <Grid >
    <VisualStateManager.VisualStateGroups>
      <VisualStateGroup x:Name="CommonStates">

        <VisualStateGroup.Transitions>

          <!--Take one half second to trasition to the MouseOver state.-->
          <VisualTransition To="MouseOver" 
            GeneratedDuration="0:0:0.5"/>
        </VisualStateGroup.Transitions>

        <VisualState x:Name="Normal" />

        <!--Change the SolidColorBrush, ButtonBrush, to red when the
            mouse is over the button.-->
        <VisualState x:Name="MouseOver">
          <Storyboard>
            <ColorAnimation Storyboard.TargetName="ButtonBrush" 
              Storyboard.TargetProperty="Color" To="Red" />
          </Storyboard>
        </VisualState>
      </VisualStateGroup>
    </VisualStateManager.VisualStateGroups>
    <Grid.Background>
      <SolidColorBrush x:Name="ButtonBrush" Color="Green"/>
    </Grid.Background>
  </Grid>
</ControlTemplate>

Poznámky

Každý VisualStateGroup obsahuje kolekci VisualState objektů. A VisualState obsahuje kolekci Storyboard objektů, které určují, jak se vzhled ovládacího prvku změní, když je ovládací prvek v určitém stavu. Například Button při stisknutí může mít poněkud jiný vzhled, než když není stisknut. Dva stavy, které definice odpovídají tomu, Button kdy je stisknuta ("Pressed") a když není ("Normal").

VisualState Přidáte k ovládacímu prvku nastavením VisualStateManager.VisualStateGroups připojené vlastnosti ovládacího prvku. Státy, které se vzájemně vylučují, umístíte do stejného VisualStateGroup. Například objekt CheckBox má dva VisualStateGroup objekty. Jeden obsahuje stavy , NormalMouseOver, Presseda Disabled. Druhá obsahuje stavy , CheckedUnCheckeda Indeterminate. Objekt CheckBox může být ve stavech MouseOver a UnChecked současně, ale nemůže být ve MouseOver stavech a Pressed současně.

I když můžete přidat VisualState objekty do libovolného prvku, představují zvláště užitečný způsob, jak ostatním umožnit předefinovat vizuální chování objektu Control. Pokud vytvoříte vlastní ovládací prvek, který používá ControlTemplate, můžete určit, ve kterých stavech může být ovládací prvek, přidáním objektu TemplateVisualStateAttribute do definice třídy. Pak každý, kdo vytvoří nový ControlTemplate pro váš ovládací prvek, může do šablony přidat VisualState objekty. Nástroj TemplateVisualStateAttribute umožňuje nástrojům návrháře, jako je Visual Studio a Blend for Visual Studio, zveřejnit stavy ovládacího prvku. Státy se stejnými TemplateVisualStateAttribute.GroupName patří do stejného VisualStateGroup.

Další informace o použití VisualStateGroup objektů v objektu ControlTemplatenajdete v tématu Přizpůsobení vzhledu existujícího ovládacího prvku vytvořením ovládacího prvkuTemplate. Další informace o tom, jak vytvořit ovládací prvky, které používají , najdete v VisualStateManagertématu Vytvoření ovládacího prvku, který má přizpůsobitelný vzhled.

Vlastnost Transitions obsahuje VisualTransition objekty, které se použijí při přechodu ovládacího prvku mezi stavy, které jsou definovány v VisualStateGroup.

Konstruktory

Vlastnosti

Metody

Událost

Platí pro