VisualStateGroup Klass

Definition

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

Arv

Object

DispatcherObject

DependencyObject

VisualStateGroup

Attribut

ContentPropertyAttribute RuntimeNamePropertyAttribute

Exempel

I följande exempel skapas en enkel ControlTemplate för en Button som innehåller en Grid. Den innehåller också ett VisualStateGroup med namnet CommonStates, som definierar tillstånden MouseOver och Normal . Har VisualStateGroup också en VisualTransition som anger att det tar en halv sekund för Grid att ändra från grönt till rött när användaren flyttar muspekaren över 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>

Kommentarer

Var och VisualStateGroup en innehåller en samling VisualState objekt. En VisualState innehåller en samling Storyboard objekt som anger hur kontrollens utseende ändras när kontrollen är i ett visst tillstånd. En kan till exempel Button ha ett något annorlunda utseende när den trycks in än när den inte trycks. Två tillstånd som Button definierar motsvarar när det trycks ("Pressed") och när det inte är ("Normal").

Du lägger till VisualState i en kontroll genom att ange den VisualStateManager.VisualStateGroups anslutna egenskapen för kontrollen. Du placerar stater som är ömsesidigt uteslutande för varandra i samma VisualStateGroup. Till exempel CheckBox har två VisualStateGroup objekt. En innehåller tillstånden , Normal, MouseOver, Pressedoch Disabled. Den andra innehåller tillstånden , Checked, UnCheckedoch Indeterminate. CheckBox Kan vara i tillstånd MouseOver och UnChecked på samma gång, men det kan inte vara i tillstånden MouseOver och Pressed samtidigt.

Även om du kan lägga till VisualState objekt i alla element är de ett särskilt användbart sätt att göra det möjligt för andra att omdefiniera det visuella beteendet för en Control. Om du skapar en anpassad kontroll som använder en ControlTemplatekan du ange vilka tillstånd som kontrollen kan finnas i genom att lägga till en TemplateVisualStateAttribute i dess klassdefinition. Sedan kan alla som skapar en ny ControlTemplate för din kontroll lägga till VisualState objekt i mallen. Med TemplateVisualStateAttribute kan designerverktyg, till exempel Visual Studio och Blend för Visual Studio, exponera kontrollens tillstånd. Tillstånd med samma TemplateVisualStateAttribute.GroupName hör hemma i samma VisualStateGroup.

Mer information om hur du använder VisualStateGroup objekt i en ControlTemplatefinns i Skapa en mall för en kontroll. Mer information om hur du skapar kontroller som använder finns i VisualStateManagerSkapa en kontroll som har ett anpassningsbart utseende.

Egenskapen Transitions innehåller VisualTransition objekt som tillämpas när kontrollövergången mellan tillstånd som definieras i VisualStateGroup.