FrameworkElement.BeginStoryboard 方法

定義

命名空間:: System.Windows

組件:: PresentationFramework.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

開始所提供分鏡腳本中包含的動作順序。

多載

名稱	Description
BeginStoryboard(Storyboard)	開始包含在所提供分鏡圖中的行動序列。
BeginStoryboard(Storyboard, HandoffBehavior)	開始提供分鏡圖中包含的動作序列，並指定若該屬性已動畫化時應有的選項。
BeginStoryboard(Storyboard, HandoffBehavior, Boolean)	開始提供分鏡圖中包含的動作序列，並指定動畫啟動後控制的狀態。

BeginStoryboard(Storyboard)

開始包含在所提供分鏡圖中的行動序列。

public:
 void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard);

public void BeginStoryboard(System.Windows.Media.Animation.Storyboard storyboard);

member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard -> unit

Public Sub BeginStoryboard (storyboard As Storyboard)

參數

storyboard: Storyboard

要開始的分鏡腳本。

範例

以下範例是從資源取得 a Storyboard ，並在處理內部事件時執行該 Storyboard 事件。

private void OnImage1Animate(object sender, RoutedEventArgs e)
{
    Storyboard s;

    s = (Storyboard)this.FindResource("RotateStoryboard");
    this.BeginStoryboard(s);
}

Private Sub OnImage1Animate(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim s As Storyboard

    s = CType(Me.FindResource("RotateStoryboard"), Storyboard)
    Me.BeginStoryboard(s)
End Sub

備註

大多數典型的動畫案例不會使用此方法。通常，你會在標記中建立 Storyboard OR BeginStoryboard 元素，然後把它們作為 EventTrigger 內容放在一個元素上。由事件觸發時，動畫接著會執行。大多數控制面向 Storyboard 可以透過標記中暴露的屬性來解決。

對於不使用 isControllable、參數或指定參數時 false的簽名，動畫所關聯的時間軸時鐘會在動畫進入「填充」期間時立即移除。因此，執行一次之後，就無法重新啟動動畫。控制動畫還需要分鏡板有 x：Name 指令，或能透過程式碼中參考。

適用於

BeginStoryboard(Storyboard, HandoffBehavior)

開始提供分鏡圖中包含的動作序列，並指定若該屬性已動畫化時應有的選項。

public:
 void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard, System::Windows::Media::Animation::HandoffBehavior handoffBehavior);

public void BeginStoryboard(System.Windows.Media.Animation.Storyboard storyboard, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);

member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard * System.Windows.Media.Animation.HandoffBehavior -> unit

Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior)

參數

storyboard: Storyboard

要開始的分鏡腳本。

handoffBehavior: HandoffBehavior

列舉值，這個值描述腳本中所述的屬性已經以動畫顯示時所要使用的行為。

範例

以下範例是從資源取得 a Storyboard ，並在處理內部事件時執行該 Storyboard 事件。

private void OnImage1Animate(object sender, RoutedEventArgs e)
{
    Storyboard s;

    s = (Storyboard)this.FindResource("RotateStoryboard");
    this.BeginStoryboard(s);
}

Private Sub OnImage1Animate(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim s As Storyboard

    s = CType(Me.FindResource("RotateStoryboard"), Storyboard)
    Me.BeginStoryboard(s)
End Sub

備註

切換行為可指定為屬性 BeginStoryboard。

使用 Compose HandoffBehavior

當你使用 Storyboard AnimationTimeline、、 AnimationClock 或對屬性施加Compose HandoffBehavior時，先前與該屬性相關聯的任何Clock物件仍持續消耗系統資源;計時系統不會自動移除時鐘。

為了避免在使用 Compose大量時脈時產生效能問題，應在動畫屬性完成後移除合成時鐘。有幾種方法可以拆除時鐘：

若要從屬性移除所有時鐘，請使用動畫化物件的 ApplyAnimationClock(DependencyProperty, AnimationClock) 或 BeginAnimation(DependencyProperty, AnimationTimeline) 方法。指定要顯示動畫的屬性作為第一個參數，並指定 null 作為第二個。這會從屬性中移除所有動畫時鐘。
若要從時鐘清單中移除特定 AnimationClock，請使用 Controller 的 AnimationClock 屬性來擷取 ClockController，然後呼叫 Remove 的 ClockController 方法。這通常是在時鐘的 Completed 事件處理常式中完成。請注意，只有根時鐘能被 ClockController控制; Controller 子時鐘的特性會回傳 null。同時注意， Completed 如果時鐘的有效持續時間為永久，事件不會被提升。此時，使用者必須決定何時呼叫 Remove。

這主要是在存留期較長的物件才會發生的動畫問題。當物件被垃圾回收時，其時鐘也會被斷開並進行垃圾回收。

如需時鐘物件的詳細資訊，請參閱動畫和計時系統概觀。

適用於

BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

開始提供分鏡圖中包含的動作序列，並指定動畫啟動後控制的狀態。

public:
 void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard, System::Windows::Media::Animation::HandoffBehavior handoffBehavior, bool isControllable);

public void BeginStoryboard(System.Windows.Media.Animation.Storyboard storyboard, System.Windows.Media.Animation.HandoffBehavior handoffBehavior, bool isControllable);

member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard * System.Windows.Media.Animation.HandoffBehavior * bool -> unit

Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior, isControllable As Boolean)

參數

storyboard: Storyboard

要開始的分鏡腳本。

handoffBehavior: HandoffBehavior

列舉值，這個值描述腳本中所述的屬性已經以動畫顯示時所要使用的行為。

isControllable: Boolean

宣告動畫在啟動后是否可控制（可以暫停）。

備註

切換行為可指定為屬性 BeginStoryboard。

使用 Compose HandoffBehavior

為了避免在使用 Compose大量時脈時產生效能問題，應在動畫屬性完成後移除合成時鐘。有幾種方法可以拆除時鐘：

若要從屬性移除所有時鐘，請使用動畫化物件的 ApplyAnimationClock(DependencyProperty, AnimationClock) 或 BeginAnimation(DependencyProperty, AnimationTimeline) 方法。指定要顯示動畫的屬性作為第一個參數，並指定 null 作為第二個。這會從屬性中移除所有動畫時鐘。
若要從時鐘清單中移除特定 AnimationClock，請使用 Controller 的 AnimationClock 屬性來擷取 ClockController，然後呼叫 Remove 的 ClockController 方法。這通常是在時鐘的 Completed 事件處理常式中完成。請注意，只有根時鐘能被 ClockController控制; Controller 子時鐘的特性會回傳 null。同時注意， Completed 如果時鐘的有效持續時間為永久，事件不會被提升。此時，使用者必須決定何時呼叫 Remove。

這主要是在存留期較長的物件才會發生的動畫問題。當物件被垃圾回收時，其時鐘也會被斷開並進行垃圾回收。

如需時鐘物件的詳細資訊，請參閱動畫和計時系統概觀。

適用於

意見反應

此頁面對您有幫助嗎？