VisualStateGroup Sınıf

Tanım

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

Devralma

Object

DispatcherObject

DependencyObject

VisualStateGroup

Öznitelikler

ContentPropertyAttribute RuntimeNamePropertyAttribute

Örnekler

Aşağıdaki örnek, içeren bir Button için basit ControlTemplate bir Gridoluşturur. Ayrıca ve Normal durumlarını MouseOver tanımlayan adlı CommonStatesbir VisualStateGroup içerir. VisualStateGroup ayrıca, kullanıcı fare işaretçisini üzerinde Buttonhareket ettiğinde yeşilden kırmızıya geçmesi için Grid yarım saniye sürdüğünü belirten bir VisualTransition de vardır.

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

Açıklamalar

Her VisualStateGroup biri bir nesne koleksiyonu VisualState içerir. , VisualState denetim belirli bir durumdayken denetimin görünümünün nasıl değiştiğini belirten bir nesne koleksiyonu Storyboard içerir. Örneğin, basıldığında Button , basılmadığından biraz farklı bir görünüme sahip olabilir. öğesinin, basıldığında () ve basılmadığında ("Pressed""Normal") karşılık geldiğini belirten Button iki durum.

Denetimdeki ekli özelliği ayarlayarak VisualStateManager.VisualStateGroups denetime eklersinizVisualState. Birbirini dışlayan durumları aynı VisualStateGroupiçine koyarsınız. Örneğin, iki CheckBoxVisualStateGroup nesnesi vardır. Bunlardan biri, Normal, MouseOver, Pressedve Disableddurumlarını içerir. Diğeri ise , CheckedUnCheckedve Indeterminatedurumlarını içerir. CheckBox durumlarında MouseOver ve UnChecked aynı zamanda olabilir, ancak ve Pressed durumlarında MouseOver aynı anda olamaz.

Herhangi bir öğeye nesne ekleyebilmenize VisualState rağmen, diğer kişilerin bir öğesinin görsel davranışını yeniden tanımlamasını sağlamanın özellikle yararlı bir Controlyoludur. kullanan özel bir ControlTemplatedenetim oluşturursanız, sınıf tanımına bir TemplateVisualStateAttribute ekleyerek denetimin hangi durumlarda bulunabileceğini belirtebilirsiniz. Ardından, denetiminiz için yeni ControlTemplate bir oluşturan herkes şablona nesne ekleyebilir VisualState . , denetimin TemplateVisualStateAttribute durumlarını kullanıma sunma amacıyla Visual Studio ve Visual Studio için Blend gibi tasarımcı araçlarını etkinleştirir. Aynı olan durumlar aynı TemplateVisualStateAttribute.GroupNameVisualStateGroupöğesine aittir.

içinde nesneleri kullanma VisualStateGroup hakkında daha fazla bilgi için bkz. ControlTemplate Oluşturarak Varolan Denetimin Görünümünü Özelleştirme.ControlTemplate kullanan VisualStateManagerdenetimlerin nasıl oluşturulacağı hakkında daha fazla bilgi için bkz. Özelleştirilebilir Görünüme Sahip Bir Denetim Oluşturma.

özelliğinde Transitions tanımlanan VisualStateGroupdurumlar arasında denetim geçişi yapıldığında uygulanan nesneleri içerirVisualTransition.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır