BeginStoryboard Класс

Определение

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

Microsoft.UI.Xaml.Media.Animation

Действие триггера, которое начинает раскадровки. Редко используется. См. заметки.

public ref class BeginStoryboard sealed : TriggerAction

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BeginStoryboard final : TriggerAction

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BeginStoryboard : TriggerAction

Public NotInheritable Class BeginStoryboard
Inherits TriggerAction

<BeginStoryboard ...>
  singleStoryboard
</BeginStoryboard>

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

Object Platform::Object IInspectable DependencyObject TriggerAction BeginStoryboard

Атрибуты

ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Примеры

В этом примере XAML показана базовая структура для использования FrameworkElement.Triggers с поведением триггера по умолчанию FrameworkElement.Loaded для запуска раскадровки анимации. В этом XAML показаны элементы контейнера EventTrigger и BeginStoryboard в правильной связи с каждым из них с использованием синтаксиса свойств содержимого XAML и пропущенных тегов ненужных элементов свойств (например , BeginStoryboard.Storyboard).

<Canvas Width="200" Height="200" x:Name="animatedcanvas" Background="Red">
    <Canvas.Triggers>
        <EventTrigger>
            <BeginStoryboard>
                <Storyboard x:Name="ColorStoryboard">
                   <!-- Animate the background of the canvas to green over 4 seconds. -->
                    <ColorAnimation Storyboard.TargetName="animatedcanvas"
                      Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"
                      To="Green" Duration="0:0:4"/>
                </Storyboard>
            </BeginStoryboard>
        </EventTrigger>
    </Canvas.Triggers>
</Canvas>

Комментарии

Триггеры, EventTrigger, Actions и BeginStoryboard обычно не используются. Эти API в основном существуют для обеспечения совместимости в XAML, изначально использовавшихся для Microsoft Silverlight. В большинстве сценариев, где триггеры событий использовались ранее, следует либо использовать визуальные состояния, либо запускать анимацию, написав загруженный обработчик, который ищет анимацию в ресурсах уровня страницы, а затем вызывает Begin в main раскадровки анимации. Дополнительные сведения см. в разделе Шаблоны элементов управления XAML или Раскадровки анимации.

Если вы решили использовать триггеры, в среда выполнения Windows XAML поведение по умолчанию для триггеров событий и единственным событием, которое можно использовать для вызова EventTrigger, является FrameworkElement.Loaded. Так как это поведение по умолчанию и только включено, вы не задаете RoutedEvent, а просто используете XAML <EventTrigger>. Дополнительные сведения см. в разделе Триггеры.

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

BeginStoryboard()

Инициализирует новый экземпляр класса BeginStoryboard .

Свойства

Dispatcher	Всегда возвращает в null приложении Windows App SDK. Вместо этого используйте DispatcherQueue . (Унаследовано от DependencyObject)
DispatcherQueue	Возвращает объект , DispatcherQueue с которым связан этот объект. представляет DispatcherQueue средство, которое может получить доступ к в потоке DependencyObject пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу. (Унаследовано от DependencyObject)
Storyboard	Возвращает или задает раскадровки , запускаемой этим beginStoryboard .
StoryboardProperty	Определяет свойство зависимости BeginStoryboard.Storyboard .

Методы

ClearValue(DependencyProperty)	Очищает локальное значение свойства зависимостей. (Унаследовано от DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна. (Унаследовано от DependencyObject)
GetValue(DependencyProperty)	Возвращает текущее действующее значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Регистрирует функцию уведомления для прослушивания изменений определенного DependencyProperty в этом экземпляре DependencyObject . (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей для Объекта DependencyObject. (Унаследовано от DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Отменяет уведомление об изменениях, которое было ранее зарегистрировано путем вызова Метода RegisterPropertyChangedCallback. (Унаследовано от DependencyObject)

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

• TriggerAction
• Triggers
• Storyboard
• Шаблоны элементов управления XAML