Язык

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 для кнопки , содержащей одну сетку. VisualState со значением атрибута x:Name объекта PointerOver имеет раскадровку, которая изменяет цвет содержимого кнопки (aGrid) с зеленого на красный, когда пользователь помещает указатель на 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.

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

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