VisualState.Storyboard Свойство

Определение

Пространство имен:

Microsoft.UI.Xaml

Возвращает или задает раскадровка , которая определяет значения свойств для конкретного состояния и внешний вид элемента управления при использовании этого визуального состояния.

public:
 property Storyboard ^ Storyboard { Storyboard ^ get(); void set(Storyboard ^ value); };

Storyboard Storyboard();

void Storyboard(Storyboard value);

public Storyboard Storyboard { get; set; }

var storyboard = visualState.storyboard;
visualState.storyboard = storyboard;

Public Property Storyboard As Storyboard

<VisualState>
  singleStoryboard
</VisualState>

Значение свойства

Storyboard

Раскадровка, определяющая изменения свойств, применяемые к элементу управления, когда этот visualState используется в качестве текущего визуального состояния.

Примеры

В этом примере создается простой элемент ControlTemplate для элемента Button , содержащего один элемент Grid. VisualState со значением атрибута x:Name "PointerOver" имеет раскадровка, которая изменяет цвет содержимого кнопки (a Grid) с зеленого на красный, когда пользователь направит указатель на Button. VisualState со значением атрибута x:Name "Normal" включен, чтобы при перемещении указателя с кнопки Grid фон возвращал зеленый цвет.

<ControlTemplate TargetType="Button">
  <Grid >
    <VisualStateManager.VisualStateGroups>
      <VisualStateGroup x:Name="CommonStates">

        <VisualStateGroup.Transitions>

          <!--Take one half second to transition to the PointerOver state.-->
          <VisualTransition To="PointerOver" 
                              GeneratedDuration="0:0:0.5"/>
        </VisualStateGroup.Transitions>
        
        <VisualState x:Name="Normal" />

        <!--Change the SolidColorBrush, ButtonBrush, to red when the
            Pointer is over the button.-->
        <VisualState x:Name="PointerOver">
          <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>

Комментарии

Значение свойства Storyboard равно null или одному Storyboard объекту. Объект Storyboard похож на контейнер для анимации; он может содержать одно или несколько определений анимации. Каждая такая анимация может нацелиться на определенное свойство зависимостей на определенный именованный целевой объект. Именованный целевой объект должен быть элементом в шаблоне элемента управления, который имеет значение атрибута Name или x:Name , определенное в самом шаблоне. Свойство зависимостей должно быть свойством, которое существует в объектной модели этого объекта, или присоединенным свойством. Для нацеливания анимаций используйте присоединенные свойства Storyboard.TargetName и Storyboard.TargetProperty . Дополнительные сведения о том, как определить анимацию с помощью синтаксиса XAML, а также о типах анимаций, которые можно использовать, см. в разделе Раскадровка анимации.

Анимации, влияющие на макет, потенциально являются зависимыми анимациями, которые могут иметь последствия для производительности для пользователей элемента управления при загрузке элемента управления VisualState.

См. также раздел

• Storyboard
• Раскадрованные анимации
• Шаблоны элементов управления XAML
• Пример стиля приложения и элемента управления XAML