IDCompositionAnimation::End method (dcompanimation.h)

  • Artikel

Menambahkan segmen akhir yang menandai akhir fungsi animasi.

Sintaks

HRESULT End(
  [in] double endOffset,
  [in] float  endValue
);

Parameter

[in] endOffset

Jenis: ganda

Offset, dalam detik, dari awal fungsi animasi ke titik ketika fungsi berakhir.

[in] endValue

Jenis: float

Nilai akhir animasi.

Menampilkan nilai

Jenis: HRESULT

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Lihat Kode Kesalahan DirectComposition untuk daftar kode kesalahan.

Keterangan

Ketika offset yang ditentukan tercapai, properti atau properti yang terpengaruh oleh animasi ini diatur ke nilai akhir yang ditentukan, lalu animasi berhenti. Jika tidak ada segmen akhir yang ditambahkan, segmen akhir fungsi animasi berjalan tanpa batas waktu. Memanggil metode ini secara semantik identik dengan membuat segmen terakhir dari fungsi animasi polinomial kubik di mana koefisien kubik, kuadrat, dan linier semuanya nol, dan koefisien konstan adalah nilai akhir yang diinginkan.

Karena segmen animasi harus ditambahkan dalam urutan yang meningkat, metode ini gagal jika parameter endOffset kurang dari atau sama dengan parameter beginOffset dari segmen sebelumnya. Metode ini juga gagal jika ini adalah segmen pertama yang ditambahkan ke fungsi animasi.

Setelah metode ini dipanggil, semua metode pada objek animasi ini gagal kecuali metode IDCompositionAnimation::Reset .

Persyaratan

   
Klien minimum yang didukung Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header dcompanimation.h
Pustaka Dcomp.lib
DLL Dcomp.dll

Lihat juga

IDCompositionAnimation