VisualStateGroup Klasse

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

Vererbung

Object

DispatcherObject

DependencyObject

VisualStateGroup

Attribute

ContentPropertyAttribute RuntimeNamePropertyAttribute

Beispiele

Im folgenden Beispiel wird ein einfaches ControlTemplate für ein Button erstellt, das eine Gridenthält. Sie enthält auch einen VisualStateGroup namens CommonStates, der den MouseOver Zustand und Normal definiert. verfügt VisualStateGroup auch über eine VisualTransition , die angibt, dass es eine halbe Sekunde dauert, bis sich von Grid grün in rot ändert, wenn der Benutzer den Mauszeiger über den Buttonbewegt.

<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>

Hinweise

Jedes VisualStateGroup enthält eine Auflistung von VisualState -Objekten. Ein VisualState enthält eine Auflistung von Storyboard -Objekten, die angeben, wie sich die Darstellung des Steuerelements ändert, wenn sich das Steuerelement in einem bestimmten Zustand befindet. Beispielsweise kann ein Button etwas anderes Aussehen haben, wenn es gedrückt wird, als wenn es nicht gedrückt wird. Zwei Zustände, die definiert werden Button , entsprechen, wenn es gedrückt wird ("Pressed") und wenn es nicht ("Normal") ist.

Sie fügen einem Steuerelement hinzu VisualState , indem Sie die VisualStateManager.VisualStateGroups angefügte Eigenschaft für das Steuerelement festlegen. Zustände, die sich gegenseitig ausschließen, werden in derselben VisualStateGroupplatziert. Beispielsweise verfügt das über CheckBox zwei VisualStateGroup -Objekte. Eine enthält die Zustände , NormalMouseOver, Pressedund Disabled. Die andere enthält die Zustände Checked, UnCheckedund Indeterminate. Der CheckBox kann sich in Zuständen MouseOver und UnChecked gleichzeitig befinden, aber es kann nicht gleichzeitig im MouseOver Zustand und Pressed sein.

Obwohl Sie jedem Element Objekte hinzufügen VisualState können, sind sie eine besonders nützliche Möglichkeit, um anderen das visuelle Verhalten eines Controlneu zu definieren. Wenn Sie ein benutzerdefiniertes Steuerelement erstellen, das ein ControlTemplateverwendet, können Sie angeben, in welchen Zuständen das Steuerelement sich befinden kann, indem Sie seiner Klassendefinition eine TemplateVisualStateAttribute hinzufügen. Dann kann jeder, der ein neues ControlTemplate für Ihr Steuerelement erstellt, der Vorlage Objekte hinzufügen VisualState . Ermöglicht TemplateVisualStateAttribute Designertools wie Visual Studio und Blend für Visual Studio, die Zustände des Steuerelements verfügbar zu machen. Zustände mit demselben TemplateVisualStateAttribute.GroupName gehören in dasselbe VisualStateGroup.

Weitere Informationen zur Verwendung VisualStateGroup von -Objekten in einem ControlTemplatefinden Sie unter Anpassen der Darstellung eines vorhandenen Steuerelements durch Erstellen einer ControlTemplate. Weitere Informationen zum Erstellen von Steuerelementen, die verwenden VisualStateManager, finden Sie unter Erstellen eines Steuerelements mit anpassbarer Darstellung.

Die Transitions -Eigenschaft enthält VisualTransition -Objekte, die angewendet werden, wenn das Steuerelement zwischen Zuständen wechselt, die in definiert VisualStateGroupsind.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für: