Kelas CAnimationValue

Mengimplementasikan fungsionalitas objek animasi yang memiliki satu nilai.

Sintaks

class CAnimationValue : public CAnimationBaseObject;

Anggota

Konstruktor Publik

Metode Publik

Metode yang Dilindungi

Operator Publik

Anggota Data yang Dilindungi

Keterangan

Kelas CAnimationValue merangkum satu objek CAnimationVariable dan dapat mewakili dalam aplikasi satu nilai animasi. Misalnya, Anda dapat menggunakan kelas ini untuk transparansi animasi (efek pudar), sudut (untuk memutar objek), atau untuk kasus lain ketika Anda perlu membuat animasi tergantung pada satu nilai animasi. Untuk menggunakan kelas ini dalam aplikasi, cukup buat objek kelas ini, tambahkan ke pengontrol animasi menggunakan CAnimationController::AddAnimationObject dan panggil AddTransition untuk setiap transisi yang akan diterapkan ke nilai.

Hierarki Warisan

CObject

CAnimationBaseObject

CAnimationValue

Persyaratan

Header: afxanimationcontroller.h

CAnimationValue::AddTransition

Menambahkan transisi yang akan diterapkan ke nilai.

void AddTransition(CBaseTransition* pTransition);

Parameter

pTransisi
Penunjuk ke objek transisi.

Keterangan

Panggil fungsi ini untuk menambahkan transisi ke daftar transisi internal yang akan diterapkan ke variabel animasi. Saat Anda menambahkan transisi, transisi tidak segera diterapkan dan disimpan dalam daftar internal. Transisi diterapkan (ditambahkan ke papan cerita untuk nilai tertentu) saat Anda memanggil CAnimationController::AnimateGroup.

CAnimationValue::CAnimationValue

Membuat objek CAnimationValue.

CAnimationValue();

CAnimationValue(
    DOUBLE dblDefaultValue,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Parameter

dblDefaultValue
Menentukan nilai default.

nGroupID
Menentukan ID Grup.

nObjectID
Menentukan ID Objek.

dwUserData
menentukan data yang ditentukan pengguna.

Keterangan

Membuat objek CAnimationValue dengan properti default: nilai default, ID Grup, dan ID Objek diatur ke 0.

CAnimationValue::GetAnimationVariableList

Menempatkan variabel animasi yang dienkapsulasi ke dalam daftar.

virtual void GetAnimationVariableList(
    CList<CAnimationVariable*,
    CAnimationVariable*>& lst);

Parameter

Lst
Saat fungsi kembali, fungsi berisi penunjuk ke CAnimationVariable yang mewakili nilai animasi.

CAnimationValue::GetValue

Mengambil nilai saat ini.

BOOL GetValue(DOUBLE& dblValue);
BOOL GetValue(INT32& nValue);

Parameter

dblValue
Output. Ketika fungsi mengembalikannya berisi nilai variabel animasi saat ini.

nValue
Output. Ketika fungsi mengembalikannya berisi nilai variabel animasi saat ini.

Tampilkan Nilai

TRUE jika nilai saat ini berhasil diambil; jika tidak FALSE.

Keterangan

Panggil fungsi ini untuk mengambil nilai saat ini. Implementasi ini memanggil objek COM yang dienkapsulasi, dan jika panggilan gagal, metode ini mengembalikan nilai default yang sebelumnya diatur dalam konstruktor atau dengan SetDefaultValue.

CAnimationValue::GetVariable

Menyediakan akses ke variabel animasi yang dienkapsulasi.

CAnimationVariable& GetVariable();

Tampilkan Nilai

Referensi ke variabel animasi yang dienkapsulasi.

Keterangan

Gunakan metode ini untuk mengakses variabel animasi yang dienkapsulasi. Dari CAnimationVariable Anda mendapatkan akses ke objek IUIAnimationVariable yang mendasar, yang penunjuknya dapat berupa NULL jika variabel animasi belum dibuat.

CAnimationValue::m_value

Variabel animasi yang dienkapsulasi yang mewakili nilai animasi.

CAnimationVariable m_value;

CAnimationValue::operator DOUBLE

Menyediakan konversi antara CAnimationValue dan DOUBLE.

operator DOUBLE();

Tampilkan Nilai

Nilai Nilai Animasi saat ini.

Keterangan

Menyediakan konversi antara CAnimationValue dan DOUBLE. Metode ini secara internal memanggil GetValue dan tidak memeriksa kesalahan. Jika GetValue gagal, nilai yang dikembalikan akan berisi nilai default yang sebelumnya diatur dalam konstruktor atau dengan SetDefaultValue.

CAnimationValue::operator INT32

Menyediakan konversi antara CAnimationValue dan INT32.

operator INT32();

Tampilkan Nilai

Nilai Nilai Animasi saat ini sebagai bilangan bulat.

Keterangan

Menyediakan konversi antara CAnimationValue dan INT32. Metode ini secara internal memanggil GetValue dan tidak memeriksa kesalahan. Jika GetValue gagal, nilai yang dikembalikan akan berisi nilai default yang sebelumnya diatur dalam konstruktor atau dengan SetDefaultValue.

CAnimationValue::operator=

Menetapkan nilai DOUBLE ke CAnimationValue.

void operator=(DOUBLE dblVal);
void operator=(INT32 nVal);

Parameter

dblVal
Menentukan nilai yang akan ditetapkan ke Nilai Animasi.

nVal
Menentukan nilai yang akan ditetapkan ke Nilai Animasi.

Keterangan

Menetapkan nilai DOUBLE ke CAnimationValue. Nilai ini ditetapkan sebagai nilai default untuk variabel animasi yang dienkapsulasi. Jika Anda berlangganan objek animasi ini ke peristiwa (ValueChanged atau IntegerValueChanged), Anda perlu mengaktifkan kembali peristiwa ini.

CAnimationValue::SetDefaultValue

Mengatur nilai default.

void SetDefaultValue(DOUBLE dblDefaultValue);

Parameter

dblDefaultValue
Menentukan nilai default.

Keterangan

Gunakan metode ini untuk mengatur nilai default. Nilai default dikembalikan ke aplikasi ketika animasi belum dimulai dan/atau objek COM yang mendasar belum dibuat. Jika objek COM yang mendasari yang dienkapsulasi dalam CAnimationVarible sudah dibuat, metode ini membuatnya kembali, oleh karena itu Anda mungkin perlu memanggil metode EnableValueChanged/EnableIntegerValueChanged lagi.

Lihat juga

Kelas