Udostępnij za pośrednictwem


Klasa CAnimationValue

Implementuje funkcjonalność obiektu animacji, który ma jedną wartość.

Składnia

class CAnimationValue : public CAnimationBaseObject;

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CAnimationValue::CAnimationValue Przeciążone. Tworzy obiekt CAnimationValue.

Metody publiczne

Nazwa/nazwisko opis
CAnimationValue::AddTransition Dodaje przejście, które ma zostać zastosowane do wartości.
CAnimationValue::GetValue Przeciążone. Pobiera bieżącą wartość.
CAnimationValue::GetVariable Zapewnia dostęp do hermetyzowanej zmiennej animacji.
CAnimationValue::SetDefaultValue Ustawia wartość domyślną.

Metody chronione

Nazwa/nazwisko opis
CAnimationValue::GetAnimationVariableList Umieszcza hermetyzowaną zmienną animacji na liście. (Przesłonięcia) CAnimationBaseObject::GetAnimationVariableList).

Operatory publiczne

Nazwa/nazwisko opis
CAnimationValue::operator DOUBLE Zapewnia konwersję między wartościami CAnimationValue i DOUBLE.
CAnimationValue::operator INT32 Zapewnia konwersję między CAnimationValue i INT32.
CAnimationValue::operator= Przeciążone. Przypisuje wartość INT32 do wartości CAnimationValue.

Chronione składowe danych

Nazwa/nazwisko opis
CAnimationValue::m_value Hermetyzowana zmienna animacji, która reprezentuje wartość animacji.

Uwagi

Klasa CAnimationValue hermetyzuje pojedynczy obiekt CAnimationVariable i może reprezentować w aplikacjach pojedynczą animowaną wartość. Można na przykład użyć tej klasy do animowanego przezroczystości (efekt zanikania), kąta (do obracania obiektów) lub dowolnego innego przypadku, gdy trzeba utworzyć animację w zależności od pojedynczej animowanej wartości. Aby użyć tej klasy w aplikacji, wystarczy utworzyć wystąpienie obiektu tej klasy, dodać go do kontrolera animacji przy użyciu CAnimationController::AddAnimationObject i wywołać polecenie AddTransition dla każdego przejścia, które ma zostać zastosowane do wartości.

Hierarchia dziedziczenia

Obiekt CObject

CAnimationBaseObject

CAnimationValue

Wymagania

Nagłówek: afxanimationcontroller.h

CAnimationValue::AddTransition

Dodaje przejście, które ma zostać zastosowane do wartości.

void AddTransition(CBaseTransition* pTransition);

Parametry

pTransition
Wskaźnik do przejścia obiektu.

Uwagi

Wywołaj tę funkcję, aby dodać przejście do wewnętrznej listy przejść, które mają zostać zastosowane do zmiennej animacji. Podczas dodawania przejść nie są one stosowane natychmiast i przechowywane na liście wewnętrznej. Przejścia są stosowane (dodawane do scenorysu dla określonej wartości) podczas wywoływania CAnimationController::AnimateGroup.

CAnimationValue::CAnimationValue

Tworzy obiekt CAnimationValue.

CAnimationValue();

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

Parametry

dblDefaultValue
Określa wartość domyślną.

nGroupID
Określa identyfikator grupy.

nObjectID
Określa identyfikator obiektu.

dwUserData
określa dane zdefiniowane przez użytkownika.

Uwagi

Tworzy obiekt CAnimationValue z właściwościami domyślnymi: wartość domyślna, identyfikator grupy i identyfikator obiektu są ustawione na 0.

CAnimationValue::GetAnimationVariableList

Umieszcza hermetyzowaną zmienną animacji na liście.

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

Parametry

Lst
Gdy funkcja zwróci wartość , zawiera wskaźnik CAnimationVariable reprezentujący animowaną wartość.

CAnimationValue::GetValue

Pobiera bieżącą wartość.

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

Parametry

dblValue
Wyjście. Gdy funkcja zwraca ją, zawiera bieżącą wartość zmiennej animacji.

nValue
Wyjście. Gdy funkcja zwraca ją, zawiera bieżącą wartość zmiennej animacji.

Wartość zwracana

WARTOŚĆ TRUE, jeśli bieżąca wartość została pomyślnie pobrana; w przeciwnym razie FAŁSZ.

Uwagi

Wywołaj tę funkcję, aby pobrać bieżącą wartość. Ta implementacja wywołuje hermetyzowany obiekt COM, a jeśli wywołanie zakończy się niepowodzeniem, ta metoda zwraca wartość domyślną, która została wcześniej ustawiona w konstruktorze lub z setDefaultValue.

CAnimationValue::GetVariable

Zapewnia dostęp do hermetyzowanej zmiennej animacji.

CAnimationVariable& GetVariable();

Wartość zwracana

Odwołanie do hermetyzowanej zmiennej animacji.

Uwagi

Użyj tej metody, aby uzyskać dostęp do hermetyzowanej zmiennej animacji. Z obiektu CAnimationVariable uzyskujesz dostęp do bazowego obiektu IUIAnimationVariable, którego wskaźnik może mieć wartość NULL, jeśli zmienna animacji nie została utworzona.

CAnimationValue::m_value

Hermetyzowana zmienna animacji, która reprezentuje wartość animacji.

CAnimationVariable m_value;

CAnimationValue::operator DOUBLE

Zapewnia konwersję między wartościami CAnimationValue i DOUBLE.

operator DOUBLE();

Wartość zwracana

Bieżąca wartość wartości animacji.

Uwagi

Zapewnia konwersję między wartościami CAnimationValue i DOUBLE. Ta metoda wewnętrznie wywołuje metodę GetValue i nie sprawdza błędów. Jeśli polecenie GetValue zakończy się niepowodzeniem, zwrócona wartość będzie zawierać wartość domyślną wcześniej ustawioną w konstruktorze lub za pomocą polecenia SetDefaultValue.

CAnimationValue::operator INT32

Zapewnia konwersję między CAnimationValue i INT32.

operator INT32();

Wartość zwracana

Bieżąca wartość wartości animacji jako liczba całkowita.

Uwagi

Zapewnia konwersję między CAnimationValue i INT32. Ta metoda wewnętrznie wywołuje metodę GetValue i nie sprawdza błędów. Jeśli polecenie GetValue zakończy się niepowodzeniem, zwrócona wartość będzie zawierać wartość domyślną wcześniej ustawioną w konstruktorze lub za pomocą polecenia SetDefaultValue.

CAnimationValue::operator=

Przypisuje wartość DOUBLE do wartości CAnimationValue.

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

Parametry

dblVal
Określa wartość, która ma być przypisana do wartości animacji.

nVal
Określa wartość, która ma być przypisana do wartości animacji.

Uwagi

Przypisuje wartość DOUBLE do wartości CAnimationValue. Ta wartość jest ustawiana jako wartość domyślna dla hermetyzowanej zmiennej animacji. Jeśli zasubskrybujesz ten obiekt animacji do zdarzeń (ValueChanged lub IntegerValueChanged), musisz ponownie włączyć te zdarzenia.

CAnimationValue::SetDefaultValue

Ustawia wartość domyślną.

void SetDefaultValue(DOUBLE dblDefaultValue);

Parametry

dblDefaultValue
Określa wartość domyślną.

Uwagi

Użyj tej metody, aby ustawić wartość domyślną. Wartość domyślna jest zwracana do aplikacji, gdy animacja nie została uruchomiona i/lub nie utworzono bazowego obiektu COM. Jeśli podstawowy obiekt COM hermetyzowany w CAnimationVarible został już utworzony, ta metoda ponownie go utworzy, dlatego może być konieczne ponowne wywołanie metod EnableValueChanged/EnableIntegerValueChanged.

Zobacz też

Klasy