BeginStoryboard 类

定义

命名空间:

Windows.UI.Xaml.Media.Animation

启动 情节提要的触发器操作。 不常用。 请参阅“备注”。

public ref class BeginStoryboard sealed : 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.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

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

此 XAML 示例演示使用 FrameworkElement.Triggers 及其默认 FrameworkElement.Loaded 触发器行为来运行情节提要动画的基本结构。 此 XAML 使用其 XAML 内容属性语法和省略的不必要的属性元素标记 (（如 BeginStoryboard.Storyboard) ），显示 EventTrigger 和 BeginStoryboard 容器元素与每个元素具有适当关系。

<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 主要用于在最初用于 Microsoft Silverlight 的 XAML 中实现兼容性。 对于以前使用过事件触发器的大多数方案，应使用视觉状态，或者通过编写加载的处理程序来启动动画，该处理程序在页面级资源中查找动画，然后在动画main Storyboard 上调用 Begin。 有关详细信息，请参阅 快速入门：控件模板 或 情节提要动画。

如果选择使用触发器，则Windows 运行时 XAML 中，事件触发器的默认行为和可用于调用 EventTrigger 的唯一事件是 FrameworkElement.Loaded。 由于这是默认和唯一启用的行为，因此不设置 RoutedEvent，只需使用 XAML <EventTrigger>。 有关详细信息，请参阅 触发器。

构造函数

BeginStoryboard()

初始化 BeginStoryboard 类的新实例。

属性

Dispatcher	获取与此对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
Storyboard	获取或设置此 BeginStoryboard 启动的情节提要。
StoryboardProperty	标识 BeginStoryboard.Storyboard 依赖属性。

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
GetValue(DependencyProperty)	从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject)
ReadLocalValue(DependencyProperty)	如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	注册通知函数，用于侦听此 DependencyObject 实例上对特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

另请参阅

• TriggerAction
• Triggers
• Storyboard
• 快速入门：控件模板