Share via


Klasse CAnimationVariable

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Vertegenwoordigt een animatievariabele.

Syntaxis

class CAnimationVariable;

Leden

Openbare constructors

Naam Description
CAnimationVariable::CAnimationVariable Maakt een animatievariabeleobject.
CAnimationVariable::~CAnimationVariable De destructor. Wordt aangeroepen wanneer een CAnimationVariable-object wordt vernietigd.

Openbare methoden

Naam Description
CAnimationVariable::AddTransition Hiermee voegt u een overgang toe.
CAnimationVariable::ApplyTransitions Hiermee worden overgangen van de interne lijst toegevoegd aan storyboard.
CAnimationVariable::ClearTransitions Schakelt overgangen uit.
CAnimationVariable::Create Hiermee maakt u het COM-object van de onderliggende animatievariabele.
CAnimationVariable::CreateTransitions Hiermee maakt u alle overgangen die op deze animatievariabele moeten worden toegepast.
CAnimationVariable::EnableIntegerValueChangedEvent Hiermee schakelt u de gebeurtenis IntegerValueChanged in of uit.
CAnimationVariable::EnableValueChangedEvent Hiermee schakelt u de gebeurtenis ValueChanged in of uit.
CAnimationVariable::GetDefaultValue Retourneert de standaardwaarde.
CAnimationVariable::GetParentAnimationObject Retourneert het bovenliggende animatieobject.
CAnimationVariable::GetValue Overbelast. Retourneert de huidige waarde van de animatievariabele.
CAnimationVariable::GetVariable Hiermee wordt een aanwijzer geretourneerd naar het COM-object IUIAnimationVariable.
CAnimationVariable::SetDefaultValue Hiermee stelt u de standaardwaarde in en publiceert u het COM-object IUIAnimationVariable.

Beveiligde methoden

Naam Description
CAnimationVariable::SetParentAnimationObject Hiermee stelt u de relatie tussen een animatievariabele en een animatieobject in.

Leden van openbare gegevens

Naam Description
CAnimationVariable::m_bAutodestroyTransitions Hiermee geeft u op of gerelateerde overgangsobjecten moeten worden verwijderd.

Beveiligde gegevensleden

Naam Description
CAnimationVariable::m_dblDefaultValue Hiermee geeft u de standaardwaarde op, die wordt doorgegeven aan IUIAnimationVariable.
CAnimationVariable::m_lstTransitions Bevat een lijst met overgangen die deze animatievariabele animeren.
CAnimationVariable::m_pParentObject Een aanwijzer naar een animatieobject dat deze animatievariabele inkapselt.
CAnimationVariable::m_variable Hiermee wordt een aanwijzer opgeslagen naar het COM-object IUIAnimationVariable. NULL als het COM-object nog niet is gemaakt of als het maken is mislukt.

Opmerkingen

De klasse CAnimationVariable bevat het COM-object IUIAnimationVariable. Het bevat ook een lijst met overgangen die moeten worden toegepast op de animatievariabele in een storyboard. CAnimationVariable-objecten zijn ingesloten in animatie-objecten, die in een toepassing een waarde met animatie, punt, grootte, kleur en rechthoek kunnen vertegenwoordigen.

Overnamehiƫrarchie

CAnimationVariable

Requirements

Header: afxanimationcontroller.h

CAnimationVariable::~CAnimationVariable

De destructor. Wordt aangeroepen wanneer een CAnimationVariable-object wordt vernietigd.

virtual ~CAnimationVariable();

CAnimationVariable::AddTransition

Hiermee voegt u een overgang toe.

void AddTransition(CBaseTransition* pTransition);

Parameterwaarden

pTransition
Een aanwijzer naar een overgang die moet worden toegevoegd.

Opmerkingen

Deze methode wordt aangeroepen om een overgang toe te voegen aan de interne lijst met overgangen die moeten worden toegepast op de animatievariabele. Deze lijst moet worden gewist wanneer een animatie is gepland.

CAnimationVariable::ApplyTransitions

Hiermee worden overgangen van de interne lijst toegevoegd aan storyboard.

void ApplyTransitions(
    CAnimationController* pController,
    IUIAnimationStoryboard* pStoryboard,
    BOOL bDependOnKeyframes);

Parameterwaarden

pController
Een aanwijzer naar bovenliggende animatiecontroller.

pStoryboard
Een aanwijzer naar storyboard.

bDependOnKeyframes
TRUE, als deze methode overgangen moet toevoegen die afhankelijk zijn van sleutelframes.

Opmerkingen

Met deze methode worden overgangen van de interne lijst toegevoegd aan storyboard. Het wordt meerdere keren aangeroepen vanuit de code op het hoogste niveau om overgangen toe te voegen die niet afhankelijk zijn van sleutelframes en overgangen toevoegen die afhankelijk zijn van sleutelframes. Als het COM-object van de onderliggende animatievariabele niet is gemaakt, wordt deze methode in deze fase gemaakt.

CAnimationVariable::CAnimationVariable

Maakt een animatievariabeleobject.

CAnimationVariable(DOUBLE dblDefaultValue = 0.0);

Parameterwaarden

dblDefaultValue
Hiermee geeft u de standaardwaarde.

Opmerkingen

Hiermee maakt u een animatievariabeleobject en stelt u de standaardwaarde in. Een standaardwaarde wordt gebruikt wanneer een variabele niet is geanimeerd of niet kan worden geanimeerd.

CAnimationVariable::ClearTransitions

Schakelt overgangen uit.

void ClearTransitions(BOOL bAutodestroy);

Parameterwaarden

bAutodestroy
Hiermee geeft u op of deze methode overgangsobjecten moet verwijderen.

Opmerkingen

Met deze methode worden alle overgangen uit de interne lijst met overgangen verwijderd. Als bAutodestroy TRUE is of m_bAutodestroyTransitions TRUE is, worden overgangen verwijderd. Anders moet de aanroeper de toewijzing van de overgangsobjecten ongedaan maken.

CAnimationVariable::Create

Hiermee maakt u het COM-object van de onderliggende animatievariabele.

virtual BOOL Create(IUIAnimationManager* pManager);

Parameterwaarden

pManager
Een aanwijzer naar animatiebeheer.

Retourwaarde

WAAR als de animatievariabele is gemaakt; anders ONWAAR.

Opmerkingen

Met deze methode maakt u het COM-object van de onderliggende animatievariabele en stelt u de standaardwaarde in.

CAnimationVariable::CreateTransitions

Hiermee maakt u alle overgangen die op deze animatievariabele moeten worden toegepast.

BOOL CreateTransitions(
    IUIAnimationTransitionLibrary* pLibrary,
    IUIAnimationTransitionFactory* \*not used*\);

Parameterwaarden

pLibrary
Een aanwijzer naar een IUIAnimationTransitionLibrary-interface, waarmee een bibliotheek met standaardovergangen wordt gedefinieerd.

Retourwaarde

WAAR als overgangen zijn gemaakt; anders ONWAAR.

Opmerkingen

Deze methode wordt aangeroepen door het framework wanneer deze overgangen moet maken die zijn toegevoegd aan de interne lijst met overgangen van de variabele.

CAnimationVariable::EnableIntegerValueChangedEvent

Hiermee schakelt u de gebeurtenis IntegerValueChanged in of uit.

void EnableIntegerValueChangedEvent (
    CAnimationController* pController,
    BOOL bEnable);

Parameterwaarden

pController
Een aanwijzer naar bovenliggende controller.

bEnable
TRUE - gebeurtenis inschakelen, ONWAAR - gebeurtenis uitschakelen.

Opmerkingen

Wanneer valueChanged-gebeurtenis is ingeschakeld, roept het framework de virtuele methode CAnimationController::OnAnimationIntegerValueChanged aan. U moet deze overschrijven in een klasse die is afgeleid van CAnimationController om deze gebeurtenis te kunnen verwerken. Deze methode wordt aangeroepen telkens wanneer de gehele waarde van de animatievariabele wordt gewijzigd.

CAnimationVariable::EnableValueChangedEvent

Hiermee schakelt u de gebeurtenis ValueChanged in of uit.

void EnableValueChangedEvent (
    CAnimationController* pController,
    BOOL bEnable);

Parameterwaarden

pController
Een aanwijzer naar bovenliggende controller.

bEnable
TRUE - gebeurtenis inschakelen, ONWAAR - gebeurtenis uitschakelen.

Opmerkingen

Wanneer de gebeurtenis ValueChanged is ingeschakeld, roept het framework de virtuele methode CAnimationController::OnAnimationValueChanged aan. U moet deze overschrijven in een klasse die is afgeleid van CAnimationController om deze gebeurtenis te kunnen verwerken. Deze methode wordt aangeroepen telkens wanneer de waarde van de animatievariabele wordt gewijzigd.

CAnimationVariable::GetDefaultValue

Retourneert de standaardwaarde.

DOUBLE GetDefaultValue() const;

Retourwaarde

De standaardwaarde.

Opmerkingen

Gebruik deze functie om de standaardwaarde van de animatievariabele te verkrijgen. De standaardwaarde kan worden ingesteld in constructor of door de methode SetDefaultValue.

CAnimationVariable::GetParentAnimationObject

Retourneert het bovenliggende animatieobject.

CAnimationBaseObject* GetParentAnimationObject();

Retourwaarde

Een aanwijzer naar bovenliggend animatieobject, als er een relatie tot stand is gebracht, anders NULL.

Opmerkingen

Deze methode kan worden aangeroepen om een aanwijzer op te halen naar een bovenliggend animatieobject (een container).

CAnimationVariable::GetValue

Retourneert de huidige waarde van de animatievariabele.

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

Parameterwaarden

dblValue
De huidige waarde van de animatievariabele.

nValue
De huidige waarde van de animatievariabele.

Retourwaarde

S_OK als de waarde is verkregen of als de onderliggende animatievariabele niet is gemaakt. Anders HRESULT-foutcode.

Opmerkingen

Deze methode kan worden aangeroepen om de huidige waarde van de animatievariabele op te halen. Als het onderliggende COM-object niet is gemaakt, bevat dblValue een standaardwaarde wanneer de functie wordt geretourneerd.

CAnimationVariable::GetVariable

Hiermee wordt een aanwijzer geretourneerd naar het COM-object IUIAnimationVariable.

IUIAnimationVariable* GetVariable();

Retourwaarde

Een geldige aanwijzer naar het COM-object IUIAnimationVariable of NULL als de animatievariabele niet is gemaakt of niet kan worden gemaakt.

Opmerkingen

Gebruik deze functie voor toegang tot het onderliggende COM-object IUIAnimationVariable en roep de methoden rechtstreeks aan, indien nodig.

CAnimationVariable::m_bAutodestroyTransitions

Hiermee geeft u op of gerelateerde overgangsobjecten moeten worden verwijderd.

BOOL m_bAutodestroyTransitions;

Opmerkingen

Stel deze waarde in op TRUE om verwijdering van overgangsobjecten af te dwingen wanneer ze worden verwijderd uit de interne lijst met overgangen. Als deze waarde ONWAAR is, moeten de overgangen worden verwijderd door de toepassing aan te roepen. De lijst met overgangen wordt altijd gewist nadat een animatie is gepland. De standaardwaarde is FALSE.

CAnimationVariable::m_dblDefaultValue

Hiermee geeft u de standaardwaarde op, die wordt doorgegeven aan IUIAnimationVariable.

DOUBLE m_dblDefaultValue;

CAnimationVariable::m_lstTransitions

Bevat een lijst met overgangen die deze animatievariabele animeren.

CObList m_lstTransitions;

CAnimationVariable::m_pParentObject

Een aanwijzer naar een animatieobject dat deze animatievariabele inkapselt.

CAnimationBaseObject* m_pParentObject;

CAnimationVariable::m_variable

Hiermee wordt een aanwijzer opgeslagen naar het COM-object IUIAnimationVariable. NULL als het COM-object nog niet is gemaakt of als het maken is mislukt.

ATL::CComPtr<IUIAnimationVariable> m_variable;

CAnimationVariable::SetDefaultValue

Hiermee stelt u de standaardwaarde in en publiceert u het COM-object IUIAnimationVariable.

void SetDefaultValue(DOUBLE dblDefaultValue);

Parameterwaarden

dblDefaultValue
Hiermee geeft u de nieuwe standaardwaarde.

Opmerkingen

Gebruik deze methode om de standaardwaarde opnieuw in te stellen. Met deze methode wordt het interne COM-object IUIAnimationVariable uitgebracht, dus wanneer de animatievariabele opnieuw wordt gemaakt, krijgt het onderliggende COM-object de nieuwe standaardwaarde. De standaardwaarde wordt geretourneerd door GetValue als het COM-object dat de animatievariabele vertegenwoordigt, niet wordt gemaakt of als de variabele niet is geanimeerd.

CAnimationVariable::SetParentAnimationObject

Hiermee stelt u de relatie tussen een animatievariabele en een animatieobject in.

void SetParentAnimationObject(CAnimationBaseObject* pParentObject);

Parameterwaarden

pParentObject
Een aanwijzer naar een animatieobject dat deze variabele bevat.

Opmerkingen

Deze methode wordt intern aangeroepen om een-op-een-relatie tot stand te brengen tussen een animatievariabele en een animatieobject dat het inkapselt.

Zie ook

Klassen