CAnimationBaseObject Sınıfı
Tüm animasyon nesneleri için temel sınıf.
Sözdizimi
class CAnimationBaseObject : public CObject;
Üyeler
Ortak Oluşturucular
| Veri Akışı Adı | Açıklama |
|---|---|
| CAnimationBaseObject::CAnimationBaseObject | Aşırı yüklendi. Animasyon nesnesi oluşturur. |
| CAnimationBaseObject::~CAnimationBaseObject | Yok edici. Animasyon nesnesi yok edilirken çağrılır. |
Genel Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| CAnimationBaseObject::ApplyTransitions | Kapsüllenmiş animasyon değişkeniyle görsel taslak geçişleri ekler. |
| CAnimationBaseObject::ClearTransitions | tüm ilgili geçişleri kaldırır. |
| CAnimationBaseObject::ContainsVariable | Animasyon nesnesinin belirli bir animasyon değişkeni içerip içermediğini belirler. |
| CAnimationBaseObject::CreateTransitions | Animasyon nesnesiyle ilişkili geçişler oluşturur. |
| CAnimationBaseObject::D etachFromController | Animasyon nesnesini üst animasyon denetleyicisinden ayırır. |
| CAnimationBaseObject::EnableIntegerValueChangedEvent | Değiştirilen Tamsayı Değeri olay işleyicisini ayarlar. |
| CAnimationBaseObject::EnableValueChangedEvent | Değer Değiştirildi olay işleyicisini ayarlar. |
| CAnimationBaseObject::GetAutodestroyTransitions | İlgili geçişin otomatik olarak yok edilip edilmediğini bildirir. |
| CAnimationBaseObject::GetGroupID | Geçerli Grup Kimliğini döndürür. |
| CAnimationBaseObject::GetObjectID | Geçerli Nesne Kimliğini döndürür. |
| CAnimationBaseObject::GetUserData | Kullanıcı tanımlı verileri döndürür. |
| CAnimationBaseObject::SetAutodestroyTransitions | Geçişleri otomatik olarak yok etmek için bir bayrak ayarlar. |
| CAnimationBaseObject::SetID | Yeni kimlikleri ayarlar. |
| CAnimationBaseObject::SetUserData | Kullanıcı tanımlı verileri ayarlar. |
Korumalı Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| CAnimationBaseObject::GetAnimationVariableList | İçerilen animasyon değişkenlerine yönelik işaretçileri toplar. |
| CAnimationBaseObject::SetParentAnimationObjects | Animasyon nesnesinde yer alan animasyon değişkenleri ile kapsayıcıları arasında ilişki kurar. |
Korumalı Veri Üyeleri
| Veri Akışı Adı | Açıklama |
|---|---|
| CAnimationBaseObject::m_bAutodestroyTransitions | İlgili geçişlerin otomatik olarak yok edilip edilmeyeceğini belirtir. |
| CAnimationBaseObject::m_dwUserData | Kullanıcı tanımlı verileri depolar. |
| CAnimationBaseObject::m_nGroupID | Animasyon nesnesinin Grup Kimliğini belirtir. |
| CAnimationBaseObject::m_nObjectID | Animasyon nesnesinin Nesne Kimliğini belirtir. |
| CAnimationBaseObject::m_pParentController | Üst animasyon denetleyicisine yönelik bir işaretçi. |
Açıklamalar
Bu sınıf, tüm animasyon nesneleri için temel yöntemler uygular. Animasyon nesnesi bir uygulamadaki bir değeri, noktayı, boyutu, dikdörtgeni veya rengi ve herhangi bir özel varlığı temsil edebilir. Animasyon nesneleri animasyon gruplarında depolanır (bkz. CAnimationGroup). Her grup ayrı animasyonlu olabilir ve görsel taslak analogu olarak ele alınabilir. Animasyon nesnesi, mantıksal gösterimine bağlı olarak bir veya daha fazla animasyon değişkenini kapsüller (bkz. CAnimationVariable). Örneğin, CAnimationRect dört animasyon değişkeni içerir: dikdörtgenin her kenarı için bir değişken. Her animasyon nesnesi sınıfı, kapsüllenmiş animasyon değişkenlerine geçiş uygulamak için kullanılması gereken aşırı yüklenmiş AddTransition yöntemini kullanıma sunar. Animasyon nesnesi Nesne Kimliği (isteğe bağlı olarak) ve Grup Kimliği ile tanımlanabilir. Bir animasyon nesnesini doğru gruba yerleştirmek için Grup Kimliği gereklidir, ancak Grup Kimliği belirtilmezse, nesne 0 kimliğine sahip varsayılan gruba yerleştirilir. SetID'yi farklı GroupID ile çağırırsanız, bir animasyon nesnesi başka bir gruba taşınır (gerekirse yeni bir grup oluşturulur).
Devralma Hiyerarşisi
CAnimationBaseObject
Gereksinimler
Üst bilgi: afxanimationcontroller.h
CAnimationBaseObject::~CAnimationBaseObject
Yok edici. Animasyon nesnesi yok edilirken çağrılır.
virtual ~CAnimationBaseObject();
CAnimationBaseObject::ApplyTransitions
Kapsüllenmiş animasyon değişkeniyle görsel taslak geçişleri ekler.
virtual BOOL ApplyTransitions(
IUIAnimationStoryboard* pStoryboard,
BOOL bDependOnKeyframes);
Parametreler
pStoryboard
Görsel taslak işaretçisi.
bDependOnKeyframes
FALSE olduğunda, bu yöntem yalnızca anahtar karelere bağımlı olmayan geçişleri ekler.
Dönüş Değeri
Geçişler başarıyla eklendiyse TRUE.
Açıklamalar
AddTransition (türetilmiş sınıflarda aşırı yüklenmiş yöntemler) ile eklenen ilgili geçişleri görsel taslak içine ekler.
CAnimationBaseObject::CAnimationBaseObject
Animasyon nesnesi oluşturur.
CAnimationBaseObject();
CAnimationBaseObject(
UINT32 nGroupID,
UINT32 nObjectID = (UINT32)-1,
DWORD dwUserData = 0);
Parametreler
nGroupID
Grup Kimliğini belirtir.
nObjectID
Nesne Kimliğini belirtir.
dwUserData
Animasyon nesnesiyle ilişkilendirilebilen ve daha sonra çalışma zamanında alınabilen kullanıcı tanımlı veriler.
Açıklamalar
Animasyon nesneleri oluşturur ve varsayılan Nesne Kimliği (0) ve Grup Kimliği (0) atar.
CAnimationBaseObject::ClearTransitions
tüm ilgili geçişleri kaldırır.
virtual void ClearTransitions(BOOL bAutodestroy);
Parametreler
bAutodestroy
Geçiş nesnelerinin otomatik olarak yok edilip edilmeyeceğini veya yalnızca ilgili listeden kaldırılacağını belirtir.
Açıklamalar
bAutodestroy veya m_bAutodestroyTransitions bayrağı TRUE ise tüm ilgili geçişleri kaldırır ve yok eder. Geçişler yalnızca yığında ayrılmamışsa otomatik olarak yok edilmelidir. Yukarıdaki bayraklar YANLIŞ ise, geçişler yalnızca ilgili geçişlerin iç listesinden kaldırılır.
CAnimationBaseObject::ContainsVariable
Animasyon nesnesinin belirli bir animasyon değişkeni içerip içermediğini belirler.
virtual BOOL ContainsVariable(IUIAnimationVariable* pVariable);
Parametreler
pVariable
Animasyon değişkeni işaretçisi.
Dönüş Değeri
Animasyon değişkeni animasyon nesnesinde yer alırsa TRUE; aksi takdirde YANLIŞ.
Açıklamalar
Bu yöntem, pVariable tarafından belirtilen bir animasyon değişkeninin bir animasyon nesnesi içinde yer alıp almadığını belirlemek için kullanılabilir. Animasyon nesnesi türüne bağlı olarak birkaç animasyon değişkeni içerebilir. Örneğin, CAnimationColor her renk bileşeni için bir tane (kırmızı, yeşil ve mavi) üç değişken içerir. Animasyon değişkeninin değeri değiştiğinde, Windows Animasyon API'si ValueChanged veya IntegerValueChanged olaylarını (etkinse) gönderir ve bu olayın parametresi animasyon değişkeninin IUIAnimationVariable arabirimine yönelik bir işaretçidir. Bu yöntem, bir işaretçiden kapsanan COM nesnesine animasyon işaretçisi elde etmeye yardımcı olur.
CAnimationBaseObject::CreateTransitions
Animasyon nesnesiyle ilişkili geçişler oluşturur.
BOOL CreateTransitions();
Dönüş Değeri
Geçişler başarıyla oluşturulduysa TRUE; aksi takdirde YANLIŞ.
Açıklamalar
Türetilmiş bir animasyon nesnesinde kapsüllenmiş animasyon değişkenleri listesi üzerinde döngüler oluşturur ve her animasyon değişkeniyle ilişkili geçişler oluşturur.
CAnimationBaseObject::D etachFromController
Animasyon nesnesini üst animasyon denetleyicisinden ayırır.
void DetachFromController();
Açıklamalar
Bu yöntem dahili olarak kullanılır.
CAnimationBaseObject::EnableIntegerValueChangedEvent
Değiştirilen Tamsayı Değeri olay işleyicisini ayarlar.
virtual void EnableIntegerValueChangedEvent(
CAnimationController* pController,
BOOL bEnable);
Parametreler
pController
Üst denetleyici işaretçisi.
bEnable
Değiştirilen Tamsayı Değeri olayının etkinleştirilip etkinleştirilmeymeyeceğini veya devre dışı bırakılıp devre dışı bırakılmayacağını belirtir.
Açıklamalar
Değiştirilen Tamsayı Değeri olay işleyicisi etkinleştirilirse, bu olayı CAnimationController::OnAnimationIntegerValueChanged yönteminde işleyebilirsiniz. Bu yöntem CAnimationController tarafından türetilen bir sınıfta geçersiz kılınmalıdır. Bu yöntem, animasyon tamsayı değeri her değiştiğinde çağrılır.
CAnimationBaseObject::EnableValueChangedEvent
Değer Değiştirildi olay işleyicisini ayarlar.
virtual void EnableValueChangedEvent(
CAnimationController* pController,
BOOL bEnable);
Parametreler
pController
Üst denetleyici işaretçisi.
bEnable
Değer Değiştirildi olayının etkinleştirilip etkinleştirilmeymeyeceğini veya devre dışı bırakılıp bırakılmayacağını belirtir.
Açıklamalar
Değiştirilen Değer olay işleyicisi etkinse, bu olayı CAnimationController::OnAnimationValueChanged yönteminde işleyebilirsiniz. Bu yöntem CAnimationController türetilmiş sınıfında geçersiz kılınmalıdır. Bu yöntem, animasyon değeri her değiştiğinde çağrılır.
CAnimationBaseObject::GetAnimationVariableList
İçerilen animasyon değişkenlerine yönelik işaretçileri toplar.
virtual void GetAnimationVariableList(
CList<CAnimationVariable*,
CAnimationVariable*>& list) = 0;
Parametreler
listele
Bir animasyon nesnesinde yer alan animasyon değişkenleriyle doldurulması gereken liste.
Açıklamalar
Bu saf sanal yöntem türetilmiş bir sınıfta geçersiz kılınmalıdır. Animasyon nesnesi türüne bağlı olarak bir veya daha fazla animasyon değişkeni içerir. Örneğin, CAnimationPoint sırasıyla X ve Y koordinatları için iki değişken içerir. CAnimationBaseObject temel sınıfı, animasyon değişkenleri listesinde işlem yapan bazı genel yöntemler uygular: ApplyTransitions, ClearTransitions, EnableValueChangedEvent, EnableIntegerValueChangedEvent. Bu yöntemler getAnimationVariableList'i çağırır. Bu, belirli bir animasyon nesnesinde yer alan gerçek animasyon değişkenleriyle türetilmiş bir sınıfa doldurulur, ardından listenin üzerinde döngü yapar ve gerekli eylemleri gerçekleştirir. Özel animasyon nesnesi oluşturursanız, bu nesnede bulunan tüm animasyon değişkenlerini listelemek için eklemeniz gerekir.
CAnimationBaseObject::GetAutodestroyTransitions
İlgili geçişin otomatik olarak yok edilip edilmediğini bildirir.
BOOL GetAutodestroyTransitions() const;
Dönüş Değeri
TRUE ise ilgili geçişler otomatik olarak yok edilir; FALSE ise, geçiş nesneleri uygulama çağrılarak serbest bırakılmalıdır.
Açıklamalar
Varsayılan olarak bu bayrak TRUE'dur. Bu bayrağı yalnızca yığında geçiş ayırdıysanız ayarlayın ve/veya geçişler çağıran uygulama tarafından serbest bırakılmalıdır.
CAnimationBaseObject::GetGroupID
Geçerli Grup Kimliğini döndürür.
UINT32 GetGroupID() const;
Dönüş Değeri
Geçerli Grup Kimliği.
Açıklamalar
Grup Kimliğini almak için bu yöntemi kullanın. Grup Kimliği oluşturucuda veya SetID ile açıkça ayarlanmamışsa 0 olur.
CAnimationBaseObject::GetObjectID
Geçerli Nesne Kimliğini döndürür.
UINT32 GetObjectID() const;
Dönüş Değeri
Geçerli Nesne Kimliği.
Açıklamalar
Nesne Kimliğini almak için bu yöntemi kullanın. Nesne Kimliği oluşturucuda veya SetID ile açıkça ayarlanmamışsa 0 olur.
CAnimationBaseObject::GetUserData
Kullanıcı tanımlı verileri döndürür.
DWORD GetUserData() const;
Dönüş Değeri
Özel verilerin değeri.
Açıklamalar
Çalışma zamanında özel verileri almak için bu yöntemi çağırın. Oluşturucuda veya SetUserData ile açıkça başlatılmadıysa döndürülen değer 0 olur.
CAnimationBaseObject::m_bAutodestroyTransitions
İlgili geçişlerin otomatik olarak yok edilip edilmeyeceğini belirtir.
BOOL m_bAutodestroyTransitions;
CAnimationBaseObject::m_dwUserData
Kullanıcı tanımlı verileri depolar.
DWORD m_dwUserData;
CAnimationBaseObject::m_nGroupID
Animasyon nesnesinin Grup Kimliğini belirtir.
UINT32 m_nGroupID;
CAnimationBaseObject::m_nObjectID
Animasyon nesnesinin Nesne Kimliğini belirtir.
UINT32 m_nObjectID;
CAnimationBaseObject::m_pParentController
Üst animasyon denetleyicisine yönelik bir işaretçi.
CAnimationController* m_pParentController;
CAnimationBaseObject::SetAutodestroyTransitions
Geçişleri otomatik olarak yok etmek için bir bayrak ayarlar.
void SetAutodestroyTransitions(BOOL bValue);
Parametreler
bValue
Otomatik yok etme bayrağını belirtir.
Açıklamalar
Bu bayrağı yalnızca yeni işlecini kullanarak geçiş nesneleri ayırdıysanız ayarlayın. Bir nedenle geçiş nesneleri yığında ayrılırsa, otomatik yok etme bayrağı YANLIŞ olmalıdır. Varsayılan olarak bu bayrak TRUE'dur.
CAnimationBaseObject::SetID
Yeni kimlikleri ayarlar.
void SetID(
UINT32 nObjectID,
UINT32 nGroupID = 0);
Parametreler
nObjectID
Yeni Nesne Kimliğini belirtir.
nGroupID
Yeni Grup Kimliğini belirtir.
Açıklamalar
Nesne Kimliğini ve Grup Kimliğini değiştirmenize olanak tanır. Yeni Grup Kimliği geçerli kimlikten farklıysa, animasyon nesnesi başka bir gruba taşınır (gerekirse yeni bir grup oluşturulur).
CAnimationBaseObject::SetParentAnimationObjects
Animasyon nesnesinde yer alan animasyon değişkenleri ile kapsayıcıları arasında ilişki kurar.
virtual void SetParentAnimationObjects();
Açıklamalar
Bu yardımcı, bir animasyon nesnesinde yer alan animasyon değişkenleri ile kapsayıcıları arasında ilişki kurmak için kullanılabilir. Animasyon değişkenleri üzerinde döngüler oluşturur ve her animasyon değişkeni için bir üst animasyon nesnesine bir geri işaretçisi ayarlar. Geçerli uygulamada, gerçek ilişki CAnimationBaseObject::ApplyTransitions içinde oluşturulur, bu nedenle siz CAnimationGroup::Animate çağrılana kadar geri işaretçileri ayarlanmaz. olayları işlerken ve CAnimationVariable'dan bir üst animasyon nesnesi almanız gerektiğinde ilişkiyi bilmek yararlı olabilir. CAnimationVariable::GetParentAnimationObject kullanın.
CAnimationBaseObject::SetUserData
Kullanıcı tanımlı verileri ayarlar.
void SetUserData (DWORD dwUserData);
Parametreler
dwUserData
Özel verileri belirtir.
Açıklamalar
Özel verileri bir animasyon nesnesiyle ilişkilendirmek için bu yöntemi kullanın. Bu veriler daha sonra çalışma zamanında GetUserData tarafından alınabilir.