VisualState Класс

Определение

public ref class VisualState : System::Windows::DependencyObject

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

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

Public Class VisualState
Inherits DependencyObject

Наследование

Object

DispatcherObject

DependencyObject

VisualState

Атрибуты

ContentPropertyAttribute RuntimeNamePropertyAttribute

Примеры

В следующем примере создается VisualStateGroup в ControlTemplateButton с именем CommonStates и добавляются объекты VisualState для состояний, Normal, Pressedи MouseOver. В Button также определяется состояние, называемое Disabled, которое находится в CommonStatesVisualStateGroup, но в примере он не используется для краткости. Полный пример см. в настройке внешнего вида существующего элемента управления путем создания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>

Комментарии

VisualState указывает, как элемент управления выглядит, когда он находится в определенном состоянии. Например, при нажатии Button его граница может отличаться от обычного цвета. Класс VisualState имеет свойство Storyboard, которое изменяет внешний вид элемента управления. Когда элемент управления вводит состояние, указанное свойством VisualState.Name, начинается Storyboard. Когда элемент управления выходит из состояния, Storyboard останавливается.

Свойство VisualStateGroup.States содержит объекты VisualState. VisualStateGroup объекты добавляются в присоединенное свойство VisualStateManager.VisualStateGroups, которое определяется на FrameworkElement. Вы можете добавлять объекты VisualState в любой FrameworkElement, но обычно они используются в ControlTemplateControl. Сведения о создании ControlTemplate и VisualState объектов для существующих элементов управления см. в настройке внешнего вида существующего элемента управления путем созданияControlTemplate. Пример использования объектов VisualState за пределами ControlTemplateсм. в классе VisualStateManager.

Конструкторы

Свойства

Методы

Применяется к