QPropertyAnimation

La classe QPropertyAnimation anime les propri�t�s Qt. Plus d'informations...

#include <QPropertyAnimation>

Voir la position dans l'arbre des classes.

H�ritage

H�rite de QVariantAnimation.

Description d�taill�e

La classe QPropertyAnimation anime les propri�t�s Qt.

QPropertyAnimation interpole les propri�t�s Qt. Comme les valeurs de propri�t�s sont stock�es dans des QVariant, la classe h�rite de QVariantAnimation et supporte une animation du m�me type variant que sa classe sup�rieure.

Une classe d�clarant des propri�t�s doit �tre un QObject. Pour rendre possible l'animation de propri�t�s, elle doit fournir un modificateur (ainsi la QPropertyAnimation peut modifier la valeur de la propri�t�). Notez que cela permet d'animer de nombreux widgets Qt. Regardons un exemple :

QPropertyAnimation *animation = new QPropertyAnimation(myWidget, "geometry");
animation->setDuration(10000);
animation->setStartValue(QRect(0, 0, 100, 30));
animation->setEndValue(QRect(250, 250, 100, 30));
 
animation->start();

Le nom de la propri�t� et l'instance de QObject de la propri�t� � animer sont pass�s au constructeur. Vous pouvez ensuite sp�cifier la valeur de d�but et de fin de la propri�t�. La proc�dure est la m�me pour les propri�t�s dans des classes que vous avez impl�ment�es vous-m�me. V�rifiez juste avec QVariantAnimation que votre type QVariant est support�.

La description de la classe QVariantAnimation explique comment param�trer l'animation en d�tail. Notez toutefois que si une valeur de d�part n'est pas param�tr�e, la propri�t� commencera � la valeur qu'elle avait quand l'instance de QPropertyAnimation a �t� cr��e.

QPropertyAnimation fonctionne tout seul comme par magie. Pour des animations complexes qui, par exemple, contiennent de nombreux objets, QAnimationGroup est pr�vu. Un groupe d'animations est une animation qui peut contenir d'autres animations et qui peut g�rer quand ces animations sont jou�es. Regardez dans QParallelAnimationGroup pour avoir un exemple.

Voir aussi QVariantAnimation, QAnimationGroup et Le framework animation.

Propri�t�s

propertyName : QByteArray

Cette propri�t� contient et d�finit le nom de la propri�t� cible pour cette animation.

Le nom de la propri�t� est n�cessaire pour que l'animation puisse op�rer.

Fonctions d'acc�s

QByteArray propertyName () const
void setPropertyName ( const QByteArray & propertyName )

targetObject : QObject *

Cette propri�t� contient et d�finit le QObject cible pour cette animation.

Fonctions d'acc�s

QObject * targetObject () const
void setTargetObject ( QObject * target )

Fonctions membres

QPropertyAnimation::QPropertyAnimation ( QObject * parent = 0 )

Construit un objet QPropertyAnimation. parent est pass� au constructeur de QObject.

QPropertyAnimation::QPropertyAnimation ( QObject * target, const QByteArray & propertyName, QObject * parent = 0 )

Construit un objet QPropertyAnimation. parent est pass� au constructeur de QObject. L'animation change la propri�t� propertyName sur l'objet target. La dur�e par d�faut est de 250 ms.

Voir aussi targetObject et propertyName.

QPropertyAnimation::~QPropertyAnimation ()

D�truit l'instance de QPropertyAnimation.

bool QPropertyAnimation::event ( QEvent * event ) [virtual protected]

R�impl�mentation de QObject::event().

void QPropertyAnimation::updateCurrentValue ( const QVariant & value ) [virtual protected]

R�impl�mentation de QVariantAnimation::updateCurrentValue().

Cette fonction virtuelle est appel�e par QVariantAnimation quand la valeur courante change. value est la nouvelle valeur mise � jour. Elle met � jour la valeur courante de la propri�t� de l'objet cible.

Voir aussi currentValue et currentTime.

void QPropertyAnimation::updateState ( QAbstractAnimation::State newState, QAbstractAnimation::State oldState ) [virtual protected]

R�impl�mentation de QAbstractAnimation::updateState().

Si la valeur startValue n'est pas d�finie lorsque l'�tat de l'animation change de Stopped � Running, la valeur courante de la propri�t� est utilis�e comme valeur initiale de l'animation.

Remerciements

Merci � Jonathan Courtois pour la traduction et � Thibaut Cuvelier ainsi qu'� Jacques Thery pour leur relecture !