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.Loaded觸發程式列為使用FrameworkElement.Triggers的基本結構，以執行腳本動畫。 這個 XAML 會顯示 EventTrigger 和 BeginStoryboard 容器元素，與每個元素使用其 XAML 內容屬性語法和不必要的屬性元素標記， (例如 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>

備註

通常不會使用觸發程式、EventTrigger、Actions和 BeginStoryboard。 這些 API 主要存在於原本用於 Microsoft Silverlight 的 XAML 中相容性。 對於先前使用事件觸發程式的大部分案例，您應該使用視覺狀態，或藉由撰寫在頁面層級資源中查閱動畫的Loaded處理常式來啟動動畫，然後在動畫的主要分鏡腳本上呼叫Begin。 如需詳細資訊，請參閱 快速入門：控制項範本 或 腳本動畫。

如果您選擇使用觸發程式，請在 Windows 執行階段 XAML 中，事件觸發程式的預設行為，以及可用來叫用EventTrigger的唯一事件是FrameworkElement.Loaded。 因為這是預設和唯一啟用的行為，所以您不會設定 RoutedEvent，而只使用 XAML <EventTrigger> 。 如需詳細資訊，請參閱 觸發程式。

建構函式

BeginStoryboard()

初始化 BeginStoryboard 類別的新實例。

屬性

Dispatcher	取得這個 物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可在 UI 執行緒上存取DependencyObject的功能，即使程式碼是由非 UI 執行緒起始也一樣。 (繼承來源 DependencyObject)
Storyboard	取得或設定這個BeginStoryboard 啟動的 Storyboard。
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
• 快速入門：控制項範本