BeginStoryboard 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
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>
- 继承
- 属性
示例
此 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情节提要上调用 Begin。 有关详细信息,请参阅 XAML 控件模板 或 情节提要动画。
如果选择使用触发器,Windows 运行时 XAML 中,事件触发器的默认行为以及可用于调用 EventTrigger 的唯一事件是 FrameworkElement.Loaded。 由于这是默认行为和唯一启用的行为,因此不要设置 RoutedEvent,只需使用 XAML <EventTrigger>
。 有关详细信息,请参阅 触发器。
构造函数
BeginStoryboard() |
初始化 BeginStoryboard 类的新实例。 |
属性
Dispatcher |
始终在Windows 应用 SDK应用中返回 |
DispatcherQueue |
获取 |
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) |