Udostępnij za pośrednictwem


Klasa CAnimationRect

Implementuje funkcjonalność prostokąta, którego boki można animować.

Składnia

class CAnimationRect : public CAnimationBaseObject;

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CAnimationRect::CAnimationRect Przeciążone. Tworzy obiekt rect animacji.

Metody publiczne

Nazwa/nazwisko opis
CAnimationRect::AddTransition Dodaje przejścia dla współrzędnych lewej, górnej, prawej i dolnej.
CAnimationRect::GetBottom Zapewnia dostęp do obiektu CAnimationVariable reprezentującego współrzędną dolną.
CAnimationRect::GetDefaultValue Zwraca wartości domyślne dla granic prostokąta.
CAnimationRect::GetLeft Zapewnia dostęp do obiektu CAnimationVariable reprezentującego współrzędną po lewej stronie.
CAnimationRect::GetRight Zapewnia dostęp do obiektu CAnimationVariable reprezentującego prawą współrzędną.
CAnimationRect::GetTop Zapewnia dostęp do obiektu CAnimationVariable reprezentującego górną współrzędną.
CAnimationRect::GetValue Zwraca bieżącą wartość.
CAnimationRect::SetDefaultValue Ustawia wartość domyślną.

Metody chronione

Nazwa/nazwisko opis
CAnimationRect::GetAnimationVariableList Umieszcza hermetyzowane zmienne animacji na liście. (Przesłonięcia) CAnimationBaseObject::GetAnimationVariableList).

Operatory publiczne

Nazwa/nazwisko opis
CAnimationRect::operator RECT Konwertuje CAnimationRect na RECT.
CAnimationRect::operator= Przypisuje rect do CAnimationRect.

Publiczne elementy członkowskie danych

Nazwa/nazwisko opis
CAnimationRect::m_bFixedSize Określa, czy prostokąt ma stały rozmiar.

Chronione składowe danych

Nazwa/nazwisko opis
CAnimationRect::m_bottomValue Hermetyzowana zmienna animacji reprezentująca dolną granicę prostokąta animacji.
CAnimationRect::m_leftValue Hermetyzowana zmienna animacji reprezentująca lewą granicę prostokąta animacji.
CAnimationRect::m_rightValue Hermetyzowana zmienna animacji reprezentująca prawą granicę prostokąta animacji.
CAnimationRect::m_szInitial Określa początkowy rozmiar prostokąta animacji.
CAnimationRect::m_topValue Hermetyzowana zmienna animacji, która reprezentuje górną granicę prostokąta animacji.

Uwagi

Klasa CAnimationRect hermetyzuje cztery obiekty CAnimationVariable i może reprezentować w aplikacjach prostokąt. 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 współrzędnych lewej, prawej i dolnej.

Hierarchia dziedziczenia

Obiekt CObject

CAnimationBaseObject

CAnimationRect

Wymagania

Nagłówek: afxanimationcontroller.h

CAnimationRect::AddTransition

Dodaje przejścia dla współrzędnych lewej, górnej, prawej i dolnej.

void AddTransition(
    CBaseTransition* pLeftTransition,
    CBaseTransition* pTopTransition,
    CBaseTransition* pRightTransition,
    CBaseTransition* pBottomTransition);

Parametry

pLeftTransition
Określa przejście po lewej stronie.

pTopTransition
Określa przejście po górnej stronie.

pRightTransition
Określa przejście po prawej stronie.

pBottomTransition
Określa przejście dla dolnej strony.

Uwagi

Wywołaj tę funkcję, aby dodać określone przejścia do wewnętrznej listy przejść, które mają być stosowane do zmiennych animacji dla każdej strony prostokąta. 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. Jeśli nie musisz stosować przejścia do jednej z boków prostokąta, możesz przekazać wartość NULL.

CAnimationRect::CAnimationRect

Tworzy obiekt CAnimationRect.

CAnimationRect();

CAnimationRect(
    const CRect& rect,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

CAnimationRect(
    const CPoint& pt,
    const CSize& sz,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

CAnimationRect(
    int nLeft,
    int nTop,
    int nRight,
    int nBottom,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Parametry

Rect
Określa domyślny prostokąt.

nGroupID
Określa identyfikator grupy.

nObjectID
Określa identyfikator obiektu.

dwUserData
Określa dane zdefiniowane przez użytkownika.

Pt
Współrzędna lewego górnego rogu.

sz
Rozmiar prostokąta.

nLeft
Określa współrzędną lewej granicy.

nTop
Określa współrzędną górnej granicy.

nRight
Określa współrzędną prawej granicy.

nBottom
Określa współrzędną dolnej granicy.

Uwagi

Obiekt jest konstruowany z wartościami domyślnymi dla lewej, górnej, prawej i dolnej, identyfikatora obiektu i identyfikatora grupy, które zostaną ustawione na 0. Można je później zmienić w czasie wykonywania przy użyciu polecenia SetDefaultValue i SetID.

CAnimationRect::GetAnimationVariableList

Umieszcza hermetyzowane zmienne animacji na liście.

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

Parametry

Lst
Gdy funkcja zwraca, zawiera wskaźniki do czterech obiektów CAnimationVariable reprezentujących współrzędne prostokąta.

CAnimationRect::GetBottom

Zapewnia dostęp do obiektu CAnimationVariable reprezentującego współrzędną dolną.

CAnimationVariable& GetBottom();

Wartość zwracana

Odwołanie do hermetyzowanego CAnimationVariable reprezentującego współrzędną dolną.

Uwagi

Tę metodę można wywołać, aby uzyskać bezpośredni dostęp do bazowego obiektu CAnimationVariable reprezentującą dolną współrzędną.

CAnimationRect::GetDefaultValue

Zwraca wartości domyślne dla granic prostokąta.

CRect GetDefaultValue();

Wartość zwracana

Wartość CRect zawierająca wartości domyślne dla lewej, prawej, górnej i dolnej.

Uwagi

Wywołaj tę funkcję, aby pobrać wartość domyślną, która została wcześniej ustawiona przez konstruktor lub SetDefaultValue.

CAnimationRect::GetLeft

Zapewnia dostęp do obiektu CAnimationVariable reprezentującego współrzędną po lewej stronie.

CAnimationVariable& GetLeft();

Wartość zwracana

Odwołanie do hermetyzowanego CAnimationVariable reprezentującego współrzędną po lewej stronie.

Uwagi

Tę metodę można wywołać, aby uzyskać bezpośredni dostęp do bazowego obiektu CAnimationVariable reprezentującego współrzędną po lewej stronie.

CAnimationRect::GetRight

Zapewnia dostęp do obiektu CAnimationVariable reprezentującego prawą współrzędną.

CAnimationVariable& GetRight();

Wartość zwracana

Odwołanie do hermetyzowanego CAnimationVariable reprezentującego prawą współrzędną.

Uwagi

Tę metodę można wywołać, aby uzyskać bezpośredni dostęp do bazowego obiektu CAnimationVariable reprezentującego właściwą współrzędną.

CAnimationRect::GetTop

Zapewnia dostęp do obiektu CAnimationVariable reprezentującego górną współrzędną.

CAnimationVariable& GetTop();

Wartość zwracana

Odwołanie do hermetyzowanego CAnimationVariable reprezentującego górną współrzędną.

Uwagi

Tę metodę można wywołać, aby uzyskać bezpośredni dostęp do bazowego obiektu CAnimationVariable reprezentującego górną współrzędną.

CAnimationRect::GetValue

Zwraca bieżącą wartość.

BOOL GetValue(CRect& rect);

Parametry

Rect
Wyjście. Zawiera bieżącą wartość zwracaną przez tę metodę.

Wartość zwracana

PRAWDA, 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ść prostokąta animacji. Jeśli ta metoda nie powiedzie się lub bazowe obiekty COM dla lewej, górnej, prawej i dolnej nie zostały zainicjowane, rect zawiera wartość domyślną, która została wcześniej ustawiona w konstruktorze lub przez SetDefaultValue.

CAnimationRect::m_bFixedSize

Określa, czy prostokąt ma stały rozmiar.

BOOL m_bFixedSize;

Uwagi

Jeśli ten element członkowski ma wartość true, rozmiar prostokąta jest stały, a wartości prawe i dolne są ponownie obliczane za każdym razem, gdy lewy górny róg zostanie przeniesiony zgodnie ze stałym rozmiarem. Ustaw tę wartość na WARTOŚĆ TRUE, aby łatwo przenosić prostokąt wokół ekranu. W takim przypadku przejścia stosowane do współrzędnych prawych i dolnych są ignorowane. Rozmiar jest przechowywany wewnętrznie podczas konstruowania obiektu i/lub wywoływania metody SetDefaultValue. Domyślnie ten element członkowski ma wartość FALSE.

CAnimationRect::m_bottomValue

Hermetyzowana zmienna animacji reprezentująca dolną granicę prostokąta animacji.

CAnimationVariable m_bottomValue;

CAnimationRect::m_leftValue

Hermetyzowana zmienna animacji reprezentująca lewą granicę prostokąta animacji.

CAnimationVariable m_leftValue;

CAnimationRect::m_rightValue

Hermetyzowana zmienna animacji reprezentująca prawą granicę prostokąta animacji.

CAnimationVariable m_rightValue;

CAnimationRect::m_szInitial

Określa początkowy rozmiar prostokąta animacji.

CSize m_szInitial;

CAnimationRect::m_topValue

Hermetyzowana zmienna animacji, która reprezentuje górną granicę prostokąta animacji.

CAnimationVariable m_topValue;

CAnimationRect::operator RECT

Konwertuje CAnimationRect na RECT.

operator RECT();

Wartość zwracana

Bieżąca wartość prostokąta animacji jako RECT.

Uwagi

Ta funkcja wewnętrznie wywołuje metodę GetValue. Jeśli funkcja GetValue z jakiegoś powodu zakończy się niepowodzeniem, zwrócona funkcja RECT będzie zawierać wartości domyślne dla wszystkich współrzędnych prostokąta.

CAnimationRect::operator=

Przypisuje rect do CAnimationRect.

void operator=(const RECT& rect);

Parametry

Rect
Nowa wartość prostokąta animacji.

Uwagi

Zaleca się to zrobić przed rozpoczęciem animacji, ponieważ ten operator wywołuje metodę SetDefaultValue, która ponownie tworzy bazowe obiekty COM dla składników kolorów, jeśli zostały utworzone. Jeśli zasubskrybujesz ten obiekt animacji do zdarzeń (ValueChanged lub IntegerValueChanged), musisz ponownie włączyć te zdarzenia.

CAnimationRect::SetDefaultValue

Ustawia wartość domyślną.

void SetDefaultValue(const CRect& rect);

Parametry

Rect
Określa nowe wartości domyślne dla lewej, górnej, prawej i dolnej.

Uwagi

Użyj tej funkcji, aby ustawić wartość domyślną na obiekt animacji. Ta metoda przypisuje wartości domyślne do granic prostokąta. Tworzy również bazowe obiekty COM, jeśli zostały utworzone. Jeśli zasubskrybujesz ten obiekt animacji do zdarzeń (ValueChanged lub IntegerValueChanged), musisz ponownie włączyć te zdarzenia.

Zobacz też

Klasy