共用方式為


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

備註

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

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

建構函式

BeginStoryboard()

初始化 BeginStoryboard 類別的新實例。

屬性

Dispatcher

一律會在 null Windows 應用程式 SDK應用程式中傳回。 請改用 DispatcherQueue

(繼承來源 DependencyObject)
DispatcherQueue

DispatcherQueue取得與這個 物件相關聯的 。 DispatcherQueue表示即使程式碼是由非 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)

適用於

另請參閱