FrameworkContentElement.BeginStoryboard Yöntem

Tanım

Belirtilen film şeridinde bulunan eylemlerin sırasını başlatır.Begins the sequence of actions that are contained in the provided storyboard.

Aşırı Yüklemeler

BeginStoryboard(Storyboard)

Belirtilen film şeridinde bulunan eylemlerin sırasını başlatır.Begins the sequence of actions that are contained in the provided storyboard.

BeginStoryboard(Storyboard, HandoffBehavior)

Özellik zaten canlandırılmış ise, belirtilen film şeridinde yer alan eylemlerin sırasını başlatır.Begins the sequence of actions that are contained in the provided storyboard, with options specified for what should occur if the property is already animated.

BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

Belirtilen film şeridinde bulunan eylemlerin sırasını, bir animasyon başlatıldıktan sonra Denetim için belirtilen durumla başlatır.Begins the sequence of actions that are contained in the provided storyboard, with specified state for control of the animation after it is started.

BeginStoryboard(Storyboard)

Belirtilen film şeridinde bulunan eylemlerin sırasını başlatır.Begins the sequence of actions that are contained in the provided 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)

Parametreler

storyboard
Storyboard

Başlamak için görsel taslak.The storyboard to begin.

Açıklamalar

isControllable, Parametresini kullanmayan imzalar veya bu parametre belirtildiğinde, false "Fill" dönemine ulaştığında, animasyonla ilişkili zaman çizelgesi saatleri kaldırılır.For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks associated with the animation are removed as soon as it reaches the "Fill" period. Bu nedenle, animasyon bir kez çalıştırıldıktan sonra yeniden başlatılamaz.Therefore the animation cannot be restarted after being run once. Bir animasyonun denetlenmesi, film şeridinin kodda bir örnek olarak adlandırılmış veya erişilebilir olmasını da gerektiğini unutmayın.Note that controlling an animation also requires that the storyboard be named or accessible as an instance in code.

Şunlara uygulanır

Ürün Introduced

BeginStoryboard(Storyboard, HandoffBehavior)

Özellik zaten canlandırılmış ise, belirtilen film şeridinde yer alan eylemlerin sırasını başlatır.Begins the sequence of actions that are contained in the provided storyboard, with options specified for what should occur if the property is already animated.

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)

Parametreler

storyboard
Storyboard

Başlamak için görsel taslak.The storyboard to begin.

handoffBehavior
HandoffBehavior

Görsel taslakta açıklanan bir özellik zaten animasyonlu ise, kullanılacak davranışı açıklayan numaralandırmanın değeri.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

Açıklamalar

isControllable, Parametresini kullanmayan imzalar veya bu parametre belirtildiğinde, false "Fill" dönemine ulaştığında, animasyonla ilişkili zaman çizelgesi saatleri kaldırılır.For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks associated with the animation are removed as soon as it reaches the "Fill" period. Bu nedenle, animasyon bir kez çalıştırıldıktan sonra yeniden başlatılamaz.Therefore the animation cannot be restarted after being run once. Bir animasyonun denetlenmesi, film şeridinin kodda bir örnek olarak adlandırılmış veya erişilebilir olmasını da gerektiğini unutmayın.Note that controlling an animation also requires that the storyboard be named or accessible as an instance in code.

HandoffBehavior.Compose Özelliğini KullanmaUsing the Compose HandoffBehavior

Öğesini Storyboard kullanarak bir, AnimationTimeline veya özelliğine uyguladığınızda, AnimationClock Compose HandoffBehavior Clock daha önce bu özellikle ilişkilendirilen tüm nesneler sistem kaynaklarını kullanmaya devam eder; zamanlama sistemi saatleri otomatik olarak kaldırmaz.When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property by using the Compose HandoffBehavior, any Clock objects previously associated with that property continue to consume system resources; the timing system does not remove the clocks automatically.

Kullanarak çok sayıda saat uyguladığınızda performans sorunlarından kaçınmak için Compose , tamamlandıktan sonra animasyonlu özellikten saat oluşturmayı kaldırmanız gerekir.To avoid performance issues when you apply a large number of clocks by using Compose, you should remove composing clocks from the animated property after they complete. Saati kaldırmanın birkaç yolu vardır:There are several ways to remove a clock:

Bu, öncelikle uzun ömürlü nesneler üzerindeki animasyonlar için bir sorundur.This is primarily an issue for animations on objects that have a long lifetime. Bir nesne atık olarak toplandığında, saatlerinin de bağlantısı kesilir ve atık olarak toplanır.When an object is garbage collected, its clocks are also disconnected and garbage collected.

Saat nesneleri hakkında daha fazla bilgi için bkz. animasyon ve zamanlama sistemine genel bakış.For more information about clock objects, see Animation and Timing System Overview.

Şunlara uygulanır

Ürün Introduced

BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

Belirtilen film şeridinde bulunan eylemlerin sırasını, bir animasyon başlatıldıktan sonra Denetim için belirtilen durumla başlatır.Begins the sequence of actions that are contained in the provided storyboard, with specified state for control of the animation after it is started.

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)

Parametreler

storyboard
Storyboard

Başlamak için görsel taslak.The storyboard to begin.

handoffBehavior
HandoffBehavior

Görsel taslakta açıklanan bir özellik zaten animasyonlu ise, kullanılacak davranışı açıklayan numaralandırmanın değeri.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

isControllable
Boolean

Animasyonun, başlatıldıktan sonra denetlenebilir (duraklatılıp duraklatılamayacağını) olduğunu bildirir.Declares whether the animation is controllable (can be paused) after it is started.

Açıklamalar

isControllable, Parametresini kullanmayan imzalar veya bu parametre belirtildiğinde, false "Fill" dönemine ulaştığında, animasyonla ilişkili zaman çizelgesi saatleri kaldırılır.For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks associated with the animation are removed as soon as it reaches the "Fill" period. Bu nedenle, animasyon bir kez çalıştırıldıktan sonra yeniden başlatılamaz.Therefore the animation cannot be restarted after being run once. Bir animasyonun denetlenmesi, film şeridinin kodda bir örnek olarak adlandırılmış veya erişilebilir olmasını da gerektiğini unutmayın.Note that controlling an animation also requires that the storyboard be named or accessible as an instance in code.

HandoffBehavior.Compose Özelliğini KullanmaUsing the Compose HandoffBehavior

Öğesini Storyboard kullanarak bir, AnimationTimeline veya özelliğine uyguladığınızda, AnimationClock Compose HandoffBehavior Clock daha önce bu özellikle ilişkilendirilen tüm nesneler sistem kaynaklarını kullanmaya devam eder; zamanlama sistemi bu saatleri otomatik olarak kaldırmaz.When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property by using the Compose HandoffBehavior, any Clock objects previously associated with that property continue to consume system resources; the timing system does not remove these clocks automatically.

Kullanarak çok sayıda saat uyguladığınızda performans sorunlarından kaçınmak için Compose , tamamlandıktan sonra animasyonlu özellikten saat oluşturmayı kaldırmanız gerekir.To avoid performance issues when you apply a large number of clocks by using Compose, you should remove composing clocks from the animated property after they complete. Saati kaldırmanın birkaç yolu vardır:There are several ways to remove a clock:

Bu, öncelikle uzun ömürlü nesneler üzerindeki animasyonlar için bir sorundur.This is primarily an issue for animations on objects that have a long lifetime. Bir nesne atık olarak toplandığında, saatlerinin de bağlantısı kesilir ve atık olarak toplanır.When an object is garbage collected, its clocks are also disconnected and garbage collected.

Saat nesneleri hakkında daha fazla bilgi için bkz. animasyon ve zamanlama sistemine genel bakış.For more information about clock objects, see Animation and Timing System Overview.

Şunlara uygulanır

Ürün Introduced