VisualStateManager Класс

Определение

public ref class VisualStateManager : System::Windows::DependencyObject

public class VisualStateManager : System.Windows.DependencyObject

type VisualStateManager = class
    inherit DependencyObject

Public Class VisualStateManager
Inherits DependencyObject

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

Object

DispatcherObject

DependencyObject

VisualStateManager

Примеры

В следующем примере создается Rectangle и добавляется VisualStateGroup с именем CommonStates в присоединенное свойство VisualStateManager.VisualStatesGroups. В примере определяются объекты MouseOver и NormalVisualState в CommonStatesVisualStateGroup. Когда пользователь перемещает указатель мыши на Rectangle, он изменяется с красного на зеленый более одной половины секунды. Когда пользователь перемещает мышь от прямоугольника, Grid сразу же меняется на красный. Обратите внимание, что состояние Normal не определяет Storyboard. Storyboard не требуется, так как при переходе Rectangle из состояния MouseOver в состояние NormalStoryboard останавливается MouseOver, а свойство Color для SolidColorBrush возвращается красным.

<Rectangle Name="rect" 
           Width="100" Height="100"
           MouseEnter="rect_MouseEvent" 
           MouseLeave="rect_MouseEvent">
  <VisualStateManager.VisualStateGroups>
    <VisualStateGroup Name="MouseStates">
      <VisualState Name="MouseEnter">
        <Storyboard>
          <ColorAnimation To="Green" 
                          Storyboard.TargetName="rectBrush" 
                          Storyboard.TargetProperty="Color"/>
        </Storyboard>
      </VisualState>
      <VisualState Name="MouseLeave" />
      <VisualStateGroup.Transitions>
        <VisualTransition To="MouseLeave" GeneratedDuration="00:00:00"/>

        <VisualTransition To="MouseEnter" GeneratedDuration="00:00:00.5">
          <VisualTransition.GeneratedEasingFunction>
            <ExponentialEase EasingMode="EaseOut" Exponent="10"/>
          </VisualTransition.GeneratedEasingFunction>
        </VisualTransition>

      </VisualStateGroup.Transitions>
    </VisualStateGroup>
  </VisualStateManager.VisualStateGroups>

  <Rectangle.Fill>
    <SolidColorBrush x:Name="rectBrush" Color="Red"/>
  </Rectangle.Fill>
</Rectangle>

В следующем примере показан обработчик событий, определенный в предыдущем примере, и вызывает метод GoToElementState для перехода между состояниями. Если прямоугольник в предыдущем примере был частью ControlTemplate, примеру потребуется вызвать метод GoToState.

private void rect_MouseEvent(object sender, MouseEventArgs e)
{
    if (rect.IsMouseOver)
    {
        VisualStateManager.GoToElementState(rect, "MouseEnter", true);
    }
    else
    {
        VisualStateManager.GoToElementState(rect, "MouseLeave", true);
    }
}

Private Sub rect_MouseEvent(ByVal sender As Object, ByVal e As MouseEventArgs)
    If rect.IsMouseOver Then
        VisualStateManager.GoToElementState(rect, "MouseEnter", True)
    Else
        VisualStateManager.GoToElementState(rect, "MouseLeave", True)
    End If
End Sub

Комментарии

VisualStateManager позволяет указать состояния элемента управления, внешний вид элемента управления, когда он находится в определенном состоянии, а также при изменении состояния элемента управления. Например, Button может иметь немного другой внешний вид, если он нажимается, чем когда он не нажимается. Два состояния, что Button определяется, когда он нажимается ("Pressed") и когда он не ("Normal"). Внешний вид элемента управления, когда он находится в состоянии, определяется VisualState. VisualState содержит коллекцию объектов Storyboard, указывающих, как внешний вид элемента управления изменяется, когда элемент управления находится в этом состоянии. Вы добавляете визуальные состояния в элемент управления, задав для элемента управления VisualStateManager.VisualStateGroups присоединенное свойство. Каждая VisualStateGroup содержит коллекцию объектов VisualState, которые являются взаимоисключающими. То есть элемент управления всегда находится в одном состоянии каждого VisualStateGroup.

VisualStateManager также позволяет указать, когда элемент управления входит в определенное состояние. Метод, который необходимо вызвать для изменения состояний, зависит от вашего сценария. При создании элемента управления, использующего VisualStateManager в ControlTemplate, вызовите метод GoToState. Дополнительные сведения о создании элементов управления, использующих VisualStateManager, см. в создании элемента управления с настраиваемым внешним видом. Если вы используете VisualStateManager за пределами ControlTemplate (например, если вы используете VisualStateManager в UserControl или в одном элементе), вызовите метод GoToElementState. В любом случае VisualStateManager выполняет логику, необходимую для соответствующего запуска и остановки раскадровок, связанных с соответствующим состоянием. Например, предположим, что элемент управления определяет состояния, State1 и State2, каждый из которых имеет раскадровку, связанную с ним. Если элемент управления находится в State1, и вы передаете State2GoToState или GoToElementState, VisualStateManager запускает раскадровки в State2 и останавливает раскадровки в State1.

Элементы управления, включенные в Windows Presentation Foundation (WPF), используют VisualStateManager для изменения визуальных состояний. При создании ControlTemplate для элемента управления, включенного в WPF, можно добавить VisualState объекты в ControlTemplate элемента управления, чтобы указать внешний вид элемента управления в определенном состоянии. Чтобы найти имена визуальных состояний для элементов управления, включенных в WPF, см. стили и шаблоны элементов управления. Логика элемента управления обрабатывает переход между состояниями, поэтому вам не нужно ничего, кроме определения объектов VisualState в новом ControlTemplate. Дополнительные сведения о создании шаблонов элементов управления для существующих элементов управления см. в настройке внешнего вида существующего элемента управления путем созданияcontrolTemplate.

Если вы хотите реализовать собственную логику перехода между состояниями, необходимо наследовать от VisualStateManager, переопределить метод GoToStateCore и задать присоединенное свойство VisualStateManager.CustomVisualStateManager в элементе управления, использующего пользовательскую логику.

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

Поля

Свойства

Присоединенные свойства

Методы

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