BeginStoryboard 类

定义

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

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
属性

示例

此 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>

注解

触发器EventTriggerActions 和 BeginStoryboard 不常用。 这些 API 主要用于在最初用于 Microsoft Silverlight 的 XAML 中实现兼容性。 对于以前使用过事件触发器的大多数方案,应使用视觉状态,或者通过编写加载的处理程序来启动动画,该处理程序在页面级资源中查找动画,然后在动画的main情节提要上调用 Begin。 有关详细信息,请参阅 XAML 控件模板情节提要动画

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

构造函数

BeginStoryboard()

初始化 BeginStoryboard 类的新实例。

属性

Dispatcher

始终在Windows 应用 SDK应用中返回 null 。 请改用 DispatcherQueue

(继承自 DependencyObject)
DispatcherQueue

获取 DispatcherQueue 与此 对象关联的 。 DispatcherQueue表示可以访问 DependencyObject UI 线程上的 的功能,即使代码是由非 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)

适用于

另请参阅