FrameworkContentElement.BeginStoryboard Yöntem

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

Açıklamalar

isControllable, parametresini kullanmayan imzalar için veya bu parametre falsebelirtildiğinde, animasyonla ilişkili zaman çizelgesi saatleri "Dolgu" dönemine ulaşır ulaşmaz kaldırılır. Bu nedenle animasyon bir kez çalıştırıldıktan sonra yeniden başlatılamaz. Bir animasyonu denetlemenin, görsel şeridin kodda bir örnek olarak adlandırılması veya erişilebilir olmasını da gerektirdiğini unutmayın.

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

Açıklamalar

isControllable, parametresini kullanmayan imzalar için veya bu parametre falsebelirtildiğinde, animasyonla ilişkili zaman çizelgesi saatleri "Dolgu" dönemine ulaşır ulaşmaz kaldırılır. Bu nedenle animasyon bir kez çalıştırıldıktan sonra yeniden başlatılamaz. Bir animasyonu denetlemenin, görsel şeridin kodda bir örnek olarak adlandırılması veya erişilebilir olmasını da gerektirdiğini unutmayın.

Compose HandoffBehavior Kullanma

Compose HandoffBehaviorkullanarak bir özelliğe Storyboard, AnimationTimelineveya AnimationClock uyguladığınızda, daha önce bu özellikle ilişkilendirilmiş tüm Clock nesneleri sistem kaynaklarını kullanmaya devam eder; zamanlama sistemi saatleri otomatik olarak kaldırmaz.

Composekullanarak çok fazla sayıda saat uyguladığınızda performans sorunlarını önlemek için, animasyonlu özellik tamamlandıktan sonra oluşturma saatlerini kaldırmanız gerekir. Saati kaldırmanın birkaç yolu vardır:

• Bir özellikten tüm saatleri kaldırmak için animasyonlu nesnenin ApplyAnimationClock(DependencyProperty, AnimationClock) veya BeginAnimation(DependencyProperty, AnimationTimeline) yöntemini kullanın. Animasyonlu özelliği ilk parametre olarak, null ikinci parametre olarak belirtin. Bu, özelliğinden tüm animasyon saatlerini kaldırır.

• Belirli bir AnimationClock saat listesinden kaldırmak için, AnimationClockController özelliğini kullanarak ClockControlleralın ve ClockControllerRemove yöntemini çağırın. Bu genellikle bir saat için Completed olay işleyicisinde yapılır. Yalnızca kök saatlerin bir ClockControllertarafından denetlenebileceğini unutmayın; alt saatin Controller özelliği nulldöndürür. Saatin geçerlilik süresi sonsuza kadar ise Completed olayının tetiklenmediğini de unutmayın. Bu durumda, kullanıcının Removene zaman çağrıldığını belirlemesi gerekir.

Bu öncelikle yaşam süresi uzun olan nesnelerdeki animasyonlar için bir sorundur. Bir nesne çöp toplandığında, saatlerinin de bağlantısı kesilir ve çöp toplanır.

Saat nesneleri hakkında daha fazla bilgi için bkz. Animasyon ve Zamanlama Sistemine Genel Bakış.

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

Açıklamalar

isControllable, parametresini kullanmayan imzalar için veya bu parametre falsebelirtildiğinde, animasyonla ilişkili zaman çizelgesi saatleri "Dolgu" dönemine ulaşır ulaşmaz kaldırılır. Bu nedenle animasyon bir kez çalıştırıldıktan sonra yeniden başlatılamaz. Bir animasyonu denetlemenin, görsel şeridin kodda bir örnek olarak adlandırılması veya erişilebilir olmasını da gerektirdiğini unutmayın.

Compose HandoffBehavior Kullanma

Compose HandoffBehaviorkullanarak bir özelliğe Storyboard, AnimationTimelineveya AnimationClock uyguladığınızda, daha önce bu özellikle ilişkilendirilmiş tüm Clock nesneleri sistem kaynaklarını kullanmaya devam eder; zamanlama sistemi bu saatleri otomatik olarak kaldırmaz.

Composekullanarak çok fazla sayıda saat uyguladığınızda performans sorunlarını önlemek için, animasyonlu özellik tamamlandıktan sonra oluşturma saatlerini kaldırmanız gerekir. Saati kaldırmanın birkaç yolu vardır:

• Bir özellikten tüm saatleri kaldırmak için animasyonlu nesnenin ApplyAnimationClock(DependencyProperty, AnimationClock) veya BeginAnimation(DependencyProperty, AnimationTimeline) yöntemini kullanın. Animasyonlu özelliği ilk parametre olarak, null ikinci parametre olarak belirtin. Bu, özelliğinden tüm animasyon saatlerini kaldırır.

• Belirli bir AnimationClock saat listesinden kaldırmak için, AnimationClockController özelliğini kullanarak ClockControlleralın ve ClockControllerRemove yöntemini çağırın. Bu genellikle bir saat için Completed olay işleyicisinde yapılır. Yalnızca kök saatlerin bir ClockControllertarafından denetlenebileceğini unutmayın; alt saatin Controller özelliği nulldöndürür. Saatin geçerlilik süresi sonsuza kadar ise Completed olayının tetiklenmediğini de unutmayın. Bu durumda, kullanıcının Removene zaman çağrıldığını belirlemesi gerekir.

Bu öncelikle yaşam süresi uzun olan nesnelerdeki animasyonlar için bir sorundur. Bir nesne çöp toplandığında, saatlerinin de bağlantısı kesilir ve çöp toplanır.

Saat nesneleri hakkında daha fazla bilgi için bkz. Animasyon ve Zamanlama Sistemine Genel Bakış.