FrameworkContentElement.BeginStoryboard Metode

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Memulai urutan tindakan yang terkandung dalam papan cerita yang disediakan.

Overload

Nama	Deskripsi
BeginStoryboard(Storyboard)	Memulai urutan tindakan yang terkandung dalam papan cerita yang disediakan.
BeginStoryboard(Storyboard, HandoffBehavior)	Memulai urutan tindakan yang terkandung dalam papan cerita yang disediakan, dengan opsi yang ditentukan untuk apa yang harus terjadi jika properti sudah dianimasikan.
BeginStoryboard(Storyboard, HandoffBehavior, Boolean)	Memulai urutan tindakan yang terkandung dalam papan cerita yang disediakan, dengan status yang ditentukan untuk kontrol animasi setelah dimulai.

BeginStoryboard(Storyboard)

Memulai urutan tindakan yang terkandung dalam papan cerita yang disediakan.

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)

Parameter

storyboard

Storyboard

Papan cerita yang akan dimulai.

Keterangan

Untuk tanda tangan yang tidak menggunakan isControllableparameter , atau ketika parameter tersebut ditentukan false, jam garis waktu yang terkait dengan animasi dihapus segera setelah mencapai periode "Isi". Oleh karena itu animasi tidak dapat dimulai ulang setelah dijalankan sekali. Perhatikan bahwa mengontrol animasi juga mengharuskan papan cerita diberi nama atau dapat diakses sebagai instans dalam kode.

BeginStoryboard(Storyboard, HandoffBehavior)

Memulai urutan tindakan yang terkandung dalam papan cerita yang disediakan, dengan opsi yang ditentukan untuk apa yang harus terjadi jika properti sudah dianimasikan.

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)

Parameter

storyboard

Storyboard

Papan cerita yang akan dimulai.

handoffBehavior

HandoffBehavior

Nilai enumerasi yang menjelaskan perilaku yang akan digunakan jika properti yang dijelaskan di papan cerita sudah dianimasikan.

Keterangan

Untuk tanda tangan yang tidak menggunakan isControllableparameter , atau ketika parameter tersebut ditentukan false, jam garis waktu yang terkait dengan animasi dihapus segera setelah mencapai periode "Isi". Oleh karena itu animasi tidak dapat dimulai ulang setelah dijalankan sekali. Perhatikan bahwa mengontrol animasi juga mengharuskan papan cerita diberi nama atau dapat diakses sebagai instans dalam kode.

Menggunakan Compose HandoffBehavior

Ketika Anda menerapkan Storyboard, , AnimationTimelineatau AnimationClock ke properti dengan menggunakan ComposeHandoffBehavior, objek apa pun Clock yang sebelumnya terkait dengan properti tersebut terus menggunakan sumber daya sistem; sistem pengaturan waktu tidak menghapus jam secara otomatis.

Untuk menghindari masalah performa saat Anda menerapkan sejumlah besar jam dengan menggunakan Compose, Anda harus menghapus jam pembuatan dari properti animasi setelah selesai. Ada beberapa cara untuk menghapus jam:

• Untuk menghapus semua jam dari properti, gunakan ApplyAnimationClock(DependencyProperty, AnimationClock) metode atau BeginAnimation(DependencyProperty, AnimationTimeline) objek animasi. Tentukan properti yang dianimasikan sebagai parameter pertama, dan null sebagai yang kedua. Ini menghapus semua jam animasi dari properti.

• Untuk menghapus tertentu AnimationClock dari daftar jam, gunakan Controller properti AnimationClock untuk mengambil ClockController, lalu panggil Remove metode ClockController. Ini biasanya dilakukan di Completed penanganan aktivitas selama satu jam. Perhatikan bahwa hanya jam akar yang dapat dikontrol oleh ClockController; Controller properti jam anak mengembalikan null. Perhatikan juga bahwa Completed peristiwa tidak dinaikkan jika durasi jam yang efektif selamanya. Dalam hal ini, pengguna harus menentukan kapan harus memanggil Remove.

Ini terutama masalah untuk animasi pada objek yang memiliki masa pakai yang lama. Ketika objek dikumpulkan sampah, jamnya juga terputus dan sampah dikumpulkan.

Untuk informasi selengkapnya tentang objek jam, lihat Gambaran Umum Animasi dan Sistem Pengaturan Waktu.

BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

Memulai urutan tindakan yang terkandung dalam papan cerita yang disediakan, dengan status yang ditentukan untuk kontrol animasi setelah dimulai.

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)

Parameter

storyboard

Storyboard

Papan cerita yang akan dimulai.

handoffBehavior

HandoffBehavior

Nilai enumerasi yang menjelaskan perilaku yang akan digunakan jika properti yang dijelaskan di papan cerita sudah dianimasikan.

isControllable

Boolean

Menyatakan apakah animasi dapat dikontrol (dapat dijeda) setelah dimulai.

Keterangan

Untuk tanda tangan yang tidak menggunakan isControllableparameter , atau ketika parameter tersebut ditentukan false, jam garis waktu yang terkait dengan animasi dihapus segera setelah mencapai periode "Isi". Oleh karena itu animasi tidak dapat dimulai ulang setelah dijalankan sekali. Perhatikan bahwa mengontrol animasi juga mengharuskan papan cerita diberi nama atau dapat diakses sebagai instans dalam kode.

Menggunakan Compose HandoffBehavior

Ketika Anda menerapkan Storyboard, , AnimationTimelineatau AnimationClock ke properti dengan menggunakan ComposeHandoffBehavior, objek apa pun Clock yang sebelumnya terkait dengan properti tersebut terus menggunakan sumber daya sistem; sistem pengaturan waktu tidak menghapus jam ini secara otomatis.

Untuk menghindari masalah performa saat Anda menerapkan sejumlah besar jam dengan menggunakan Compose, Anda harus menghapus jam pembuatan dari properti animasi setelah selesai. Ada beberapa cara untuk menghapus jam:

• Untuk menghapus semua jam dari properti, gunakan ApplyAnimationClock(DependencyProperty, AnimationClock) metode atau BeginAnimation(DependencyProperty, AnimationTimeline) objek animasi. Tentukan properti yang dianimasikan sebagai parameter pertama, dan null sebagai yang kedua. Ini menghapus semua jam animasi dari properti.

• Untuk menghapus tertentu AnimationClock dari daftar jam, gunakan Controller properti AnimationClock untuk mengambil ClockController, lalu panggil Remove metode ClockController. Ini biasanya dilakukan di Completed penanganan aktivitas selama satu jam. Perhatikan bahwa hanya jam akar yang dapat dikontrol oleh ClockController; Controller properti jam anak mengembalikan null. Perhatikan juga bahwa Completed peristiwa tidak dinaikkan jika durasi jam yang efektif selamanya. Dalam hal ini, pengguna harus menentukan kapan harus memanggil Remove.

Ini terutama masalah untuk animasi pada objek yang memiliki masa pakai yang lama. Ketika objek dikumpulkan sampah, jamnya juga terputus dan sampah dikumpulkan.

Untuk informasi selengkapnya tentang objek jam, lihat Gambaran Umum Animasi dan Sistem Pengaturan Waktu.