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

屬性

ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

範例

這個 XAML 範例展示了使用 FrameworkElement.Triggers 搭配其預設 FrameworkElement.Loaded 觸發行為來執行分鏡動畫的基本結構。 此 XAML 以 XAML 內容屬性語法正確顯示 EventTrigger 與 BeginStoryboard 容器元素的關聯，並省略不必要的屬性元素標籤（如 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>

備註

觸發器、事件觸發器、動作和開始故事板並不常用。 這些 API 主要是為了相容於 XAML，XAML 最初用於 Microsoft Silverlight。 對於大多數先前使用過事件觸發器的情境，你應該使用視覺狀態，或是透過寫一個載入的處理器，在頁面層級資源中查找動畫，然後在動畫的主分鏡中呼叫 Begin 來啟動動畫。 更多資訊請參閱 XAML 控制範本 或分 鏡動畫。

如果你選擇使用 Triggers，在 Windows 執行階段 XAML 中，事件觸發器的預設行為，也是唯一可用來呼叫 EventTrigger 的事件是 FrameworkElement.Loaded。 因為這是預設且唯一啟用的行為，你不需要設定 RoutedEvent，只使用 XAML <EventTrigger>。 更多資訊請參見 「觸發點」。

另請參閱

• TriggerAction
• Triggers
• Storyboard
• XAML 控制範本