EventTrigger 类

定义

public ref class EventTrigger sealed : TriggerBase

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Actions")]
/// [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 EventTrigger final : TriggerBase

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Actions")]
[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 EventTrigger : TriggerBase

Public NotInheritable Class EventTrigger
Inherits TriggerBase

继承

Object Platform::Object IInspectable DependencyObject TriggerBase EventTrigger

属性

ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

示例

此 XAML 示例演示使用 FrameworkElement.Triggers 及其默认 FrameworkElement.Loaded 触发器行为来运行情节提要动画的基本结构。 此 XAML 使用其 XAML 内容属性语法和省略的不必要的属性元素标记，显示 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 中实现兼容性。 对于以前使用过事件触发器的大多数方案，请执行下列操作之一：

• 使用动画库中的内置动画。 请参阅 XAML 中的动画。
• 对于控件模板中的事件，请使用视觉状态和 VisualStateManager。 请参阅 XAML 控件模板。
• 对于特定于应用的 UI 动画，请在页面上定义 加载 处理程序。 此处理程序可以引用在页面级资源中定义的 Storyboard，并在该 Storyboard 上调用 Begin 方法。 请参阅 情节提要动画。

如果选择使用触发器，则Windows 运行时 XAML 中，事件触发器的默认行为和可用于调用 EventTrigger 的唯一事件是 FrameworkElement.Loaded。 由于这是默认行为，也是唯一启用的行为，因此不要设置 RoutedEvent 属性。 只需使用 XAML <EventTrigger>。 如果显式 (不建议) 设置 RoutedEvent ，则唯一有效的 XAML 是 <EventTrigger RoutedEvent="FrameworkElement.Loaded">。 不限定的“Loaded”或任何其他值会引发分析异常。 有关详细信息，请参阅 触发器。

构造函数

属性

方法

适用于

另请参阅

• TriggerBase
• Triggers
• XAML 控件模板