Classe CAnimationRect

Implementa la funzionalità di un rettangolo i cui lati possono essere animati.

Sintassi

class CAnimationRect : public CAnimationBaseObject;

Membri

Costruttori pubblici

Metodi pubblici

Metodi protetti

Operatori pubblici

Membri dati pubblici

Membri dati protetti

Osservazioni:

La classe CAnimationRect incapsula quattro oggetti CAnimationVariable e può rappresentare nelle applicazioni un rettangolo. Per usare questa classe nell'applicazione, è sufficiente creare un'istanza di un oggetto di questa classe, aggiungerla al controller di animazione usando CAnimationController::AddAnimationObject e chiamare AddTransition per ogni transizione da applicare a coordinate sinistra, superiore destra e inferiore.

Gerarchia di ereditarietà

CObject

CAnimationBaseObject

CAnimationRect

Requisiti

Intestazione: afxanimationcontroller.h

CAnimationRect::AddTransition

Aggiunge transizioni per le coordinate sinistra, superiore, destra e inferiore.

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

Parametri

pLeftTransition
Specifica la transizione per il lato sinistro.

pTopTransition
Specifica la transizione per il lato superiore.

pRightTransition
Specifica la transizione per il lato destro.

pBottomTransition
Specifica la transizione per il lato inferiore.

Osservazioni:

Chiamare questa funzione per aggiungere le transizioni specificate all'elenco interno di transizioni da applicare alle variabili di animazione per ogni lato rettangolo. Quando si aggiungono transizioni, non vengono applicate immediatamente e archiviate in un elenco interno. Le transizioni vengono applicate (aggiunte a uno storyboard per un determinato valore) quando si chiama CAnimationController::AnimateGroup. Se non è necessario applicare una transizione a uno dei lati del rettangolo, è possibile passare NULL.

CAnimationRect::CAnimationRect

Costruisce un oggetto 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);

Parametri

rect
Specifica il rettangolo predefinito.

nGroupID
Specifica l'ID gruppo.

nObjectID
Specifica l'ID oggetto.

dwUserData
Specifica i dati definiti dall'utente.

pt
Coordinata dell'angolo superiore sinistro.

sz
Dimensioni del rettangolo.

nLeft
Specifica le coordinate del limite sinistro.

nTop
Specifica le coordinate del limite superiore.

nRight
Specifica le coordinate del limite destro.

nBottom
Specifica le coordinate del limite inferiore.

Osservazioni:

L'oggetto viene costruito con valori predefiniti per sinistra, superiore, destra e inferiore, ID oggetto e ID gruppo, che verranno impostati su 0. Possono essere modificati in un secondo momento in fase di esecuzione usando SetDefaultValue e SetID.

CAnimationRect::GetAnimationVariableList

Inserisce le variabili di animazione incapsulate in un elenco.

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

Parametri

Lst
Quando la funzione viene restituita, contiene puntatori a quattro oggetti CAnimationVariable che rappresentano le coordinate del rettangolo.

CAnimationRect::GetBottom

Fornisce l'accesso a CAnimationVariable che rappresenta la coordinata inferiore.

CAnimationVariable& GetBottom();

Valore restituito

Riferimento a CAnimationVariable incapsulato che rappresenta la coordinata inferiore.

Osservazioni:

È possibile chiamare questo metodo per ottenere l'accesso diretto a CAnimationVariable sottostante che rappresenta la coordinata inferiore.

CAnimationRect::GetDefaultValue

Restituisce i valori predefiniti per i limiti del rettangolo.

CRect GetDefaultValue();

Valore restituito

Valore CRect contenente le impostazioni predefinite per sinistra, destra, superiore e inferiore.

Osservazioni:

Chiamare questa funzione per recuperare il valore predefinito, impostato in precedenza dal costruttore o da SetDefaultValue.

CAnimationRect::GetLeft

Fornisce l'accesso a CAnimationVariable che rappresenta la coordinata sinistra.

CAnimationVariable& GetLeft();

Valore restituito

Riferimento a CAnimationVariable incapsulato che rappresenta la coordinata sinistra.

Osservazioni:

È possibile chiamare questo metodo per ottenere l'accesso diretto a CAnimationVariable sottostante che rappresenta la coordinata sinistra.

CAnimationRect::GetRight

Fornisce l'accesso a CAnimationVariable che rappresenta la coordinata corretta.

CAnimationVariable& GetRight();

Valore restituito

Riferimento a CAnimationVariable incapsulato che rappresenta la coordinata destra.

Osservazioni:

È possibile chiamare questo metodo per ottenere l'accesso diretto a CAnimationVariable sottostante che rappresenta la coordinata destra.

CAnimationRect::GetTop

Fornisce l'accesso a CAnimationVariable che rappresenta la coordinata superiore.

CAnimationVariable& GetTop();

Valore restituito

Riferimento a CAnimationVariable incapsulato che rappresenta la coordinata superiore.

Osservazioni:

È possibile chiamare questo metodo per ottenere l'accesso diretto a CAnimationVariable sottostante che rappresenta la coordinata superiore.

CAnimationRect::GetValue

Restituisce il valore corrente.

BOOL GetValue(CRect& rect);

Parametri

rect
Output. Contiene il valore corrente quando viene restituito questo metodo.

Valore restituito

TRUE, se il valore corrente è stato recuperato correttamente; in caso contrario FALSE.

Osservazioni:

Chiamare questa funzione per recuperare il valore corrente del rettangolo di animazione. Se questo metodo ha esito negativo o gli oggetti COM sottostanti per sinistra, superiore, destra e inferiore non sono stati inizializzati, rect contiene il valore predefinito, precedentemente impostato nel costruttore o da SetDefaultValue.

CAnimationRect::m_bFixedSize

Specifica se il rettangolo ha dimensioni fisse.

BOOL m_bFixedSize;

Osservazioni:

Se questo membro è true, le dimensioni del rettangolo sono fisse e i valori destro e inferiore vengono ricalcolati ogni volta che l'angolo superiore sinistro viene spostato in base alle dimensioni fisse. Impostare questo valore su TRUE per spostare facilmente il rettangolo intorno allo schermo. In questo caso le transizioni applicate alle coordinate destra e inferiore vengono ignorate. Le dimensioni vengono archiviate internamente quando si costruisce l'oggetto e/o si chiama SetDefaultValue. Per impostazione predefinita, questo membro è impostato su FALSE.

CAnimationRect::m_bottomValue

Variabile di animazione incapsulata che rappresenta il limite inferiore del rettangolo di animazione.

CAnimationVariable m_bottomValue;

CAnimationRect::m_leftValue

Variabile di animazione incapsulata che rappresenta il limite sinistro del rettangolo di animazione.

CAnimationVariable m_leftValue;

CAnimationRect::m_rightValue

Variabile di animazione incapsulata che rappresenta il limite destro del rettangolo di animazione.

CAnimationVariable m_rightValue;

CAnimationRect::m_szInitial

Specifica le dimensioni iniziali del rettangolo di animazione.

CSize m_szInitial;

CAnimationRect::m_topValue

Variabile di animazione incapsulata che rappresenta il limite superiore del rettangolo di animazione.

CAnimationVariable m_topValue;

CAnimationRect::operator RECT

Converte un oggetto CAnimationRect in RECT.

operator RECT();

Valore restituito

Valore corrente del rettangolo di animazione come RECT.

Osservazioni:

Questa funzione chiama internamente GetValue. Se GetValue per qualche motivo ha esito negativo, il RECT restituito conterrà i valori predefiniti per tutte le coordinate del rettangolo.

CAnimationRect::operator=

Assegna rect a CAnimationRect.

void operator=(const RECT& rect);

Parametri

rect
Nuovo valore del rettangolo di animazione.

Osservazioni:

È consigliabile eseguire questa operazione prima dell'avvio dell'animazione, perché questo operatore chiama SetDefaultValue, che ricrea gli oggetti COM sottostanti per i componenti di colore se sono stati creati. Se hai sottoscritto questo oggetto animazione agli eventi (ValueChanged o IntegerValueChanged), devi riabilitare questi eventi.

CAnimationRect::SetDefaultValue

Imposta il valore predefinito.

void SetDefaultValue(const CRect& rect);

Parametri

rect
Specifica nuovi valori predefiniti per sinistra, superiore, destra e inferiore.

Osservazioni:

Utilizzare questa funzione per impostare un valore predefinito sull'oggetto animazione. Questi metodi assegnano valori predefiniti ai limiti del rettangolo. Ricrea anche gli oggetti COM sottostanti se sono stati creati. Se hai sottoscritto questo oggetto animazione agli eventi (ValueChanged o IntegerValueChanged), devi riabilitare questi eventi.

Vedi anche

Classi