Поделиться через


BeginStoryboard Класс

Определение

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

public ref class BeginStoryboard sealed : TriggerAction
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
class BeginStoryboard final : TriggerAction
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BeginStoryboard final : TriggerAction
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
public sealed class BeginStoryboard : TriggerAction
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Storyboard")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BeginStoryboard : TriggerAction
Public NotInheritable Class BeginStoryboard
Inherits TriggerAction
<BeginStoryboard ...>
  singleStoryboard
</BeginStoryboard>
Наследование
Object Platform::Object IInspectable DependencyObject TriggerAction BeginStoryboard
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В этом примере 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 Раскадровка анимации. Дополнительные сведения см. в статье Краткое руководство. Шаблоны элементов управления или раскадровка анимации.

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

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

BeginStoryboard()

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

Свойства

Dispatcher

Возвращает CoreDispatcher , с которым связан этот объект. CoreDispatcher представляет средство, которое может получить доступ к 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)

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

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