QSizeF

La classe QSizeF d�finit la taille d'un objet bidimensionnel en utilisant des points � pr�cision flottante. Plus d'informations...

 #include <QSizeF>

Description d�taill�e

La classe QSizeF d�finit la taille d'un objet bidimensionnel en utilisant des points � pr�cision flottante.

Une taille est sp�cifi�e par une largeur (width()) et une hauteur (height()). Elle peut �tre d�finie dans le constructeur et chang�e en utilisant les fonctions setWidth(), setHeight() ou scale() ou encore en utilisant les op�rateurs arithm�tiques. Une taille peut �galement �tre manipul�e directement en r�cup�rant les r�f�rences aux largeur et hauteur en utilisant les fonctions rwidth() et rheight(). Enfin, la largeur et la hauteur peuvent �tre �chang�es en utilisant la fonction transpose().

La fonction isValid() d�termine si une taille est valide (une taille valide a une largeur et une hauteur sup�rieures � z�ro). La fonction isEmpty() retourne vrai si, soit la largeur, soit la hauteur est inf�rieure ou �gale � z�ro, tandis que la fonction isNull() retourne vrai seulement si la largeur et la hauteur valent z�ro.

Utiliser la fonction expandedTo() afin de r�cup�rer une QSize avec la hauteur et largeur maximale qui contient cet objet et une taille donn�e. De la m�me fa�on, la fonction boundedTo() retourne une QSize avec la hauteur et la largeur minimales contenant cet objet et la taille donn�e.

La classe QSizeF fournit �galement la fonction toSize() qui retourne une copie de cette objet en instance de QSize, construite en arrondissant la largeur et la hauteur � l'entier le plus proche.

Les objets QSizeF peuvent �tre �mis sur des flux et compar�s.

Voir aussi QSize, QPointF et QRectF.

Fonctions membres

QSizeF::QSizeF ()

Construit une taille invalide.

Voir aussi isValid().

QSizeF::QSizeF ( const QSize & size )

Construit une taille en utilisant une pr�cision flottante � partir de la taille size donn�e.

Voir aussi toSize().

QSizeF::QSizeF ( qreal width, qreal height )

Construit une taille avec les donn�es width et height.

QSizeF QSizeF::boundedTo ( const QSizeF & otherSize ) const

Retourne un objet QSizeF suffisamment grand pour d�tenir la largeur et la hauteur minimale de cet objet et de otherSize.

Voir aussi expandedTo() et scale().

QSizeF QSizeF::expandedTo ( const QSizeF & otherSize ) const

Retourne un objet QSizeF suffisamment grand pour d�tenir la largeur et la hauteur maximales de cet objet et de otherSize.

Voir aussi boundedTo() et scale().

qreal QSizeF::height () const

Retourne la hauteur.

Voir aussi width() et setHeight().

bool QSizeF::isEmpty () const

Retourne true si la largeur ou la hauteur est inf�rieure ou �gale � 0 ; sinon, retourne false.

Voir aussi isNull() et isValid().

bool QSizeF::isNull () const

Retourne true si la largeur et la hauteur valent 0 ; sinon, retourne false.

Voir aussi isValid() et isEmpty().

bool QSizeF::isValid () const

Retourne true si la largeur et la hauteur sont �gales ou sup�rieures � 0 ; sinon, retourne false.

Voir aussi isNull() et isEmpty().

qreal & QSizeF::rheight ()

Retourne une r�f�rence � la hauteur.

En utilisant une r�f�rence, il est possible de manipuler directement la hauteur. Par exemple :

 QSizeF size(100, 10.2);
 size.rheight() += 5.5;
 
 // size becomes (100,15.7)

Voir aussi rwidth() et setHeight().

qreal & QSizeF::rwidth ()

Retourne une r�f�rence � la largeur.

En utilisant une r�f�rence, il est possible de manipuler directement la largeur. Par exemple :

 QSizeF size(100.3, 10);
 size.rwidth() += 20.5;
 
  // size becomes (120.8,10)

Voir aussi rheight() et setWidth().

void QSizeF::scale ( qreal width, qreal height, Qt::AspectRatioMode mode )

Met � l'�chelle la taille d'un rectangle avec les donn�es width et height, selon le mode sp�cifi� :

• si mode vaut Qt::IgnoreAspectRatio, la taille est d�finie par width et height ;
• si mode vaut Qt::KeepAspectRatio, la taille courante est mise � l'�chelle d'un rectangle aussi large que possible � l'int�rieur de width et height, pr�servant un aspect proportionnel ;
• si mode vaut Qt::KeepAspectRatioByExpanding, la taille courante est mise � l'�chelle d'un rectangle aussi petit que possible � l'ext�rieur de width et height, pr�servant un aspect proportionnel.

Exemple :

 QSizeF t1(10, 12);
 t1.scale(60, 60, Qt::IgnoreAspectRatio);
 // t1 is (60, 60)
 
 QSizeF t2(10, 12);
 t2.scale(60, 60, Qt::KeepAspectRatio);
 // t2 is (50, 60)
 
 QSizeF t3(10, 12);
 t3.scale(60, 60, Qt::KeepAspectRatioByExpanding);
 // t3 is (60, 72)

Voir aussi setWidth() et setHeight().

void QSizeF::scale ( const QSizeF & size, Qt::AspectRatioMode mode )

Il s'agit d'une fonction surcharg�e.

Met � l'�chelle la taille d'un rectangle avec la donn�e size, selon le mode sp�cifi�.

void QSizeF::setHeight ( qreal height )

D�finit la hauteur � height.

Voir aussi height(), rheight() et setWidth().

void QSizeF::setWidth ( qreal width )

D�finit la largeur � width.

Voir aussi width(), rwidth() et setHeight().

QSize QSizeF::toSize () const

Retourne une copie QSize � pr�cision enti�re de cet objet.

Notez que les coordonn�es dans la taille retourn�e seront arrondies aux entiers les plus proches.

Voir aussi QSizeF().

void QSizeF::transpose ()

�change les valeurs des largeur et hauteur.

Voir aussi setWidth() et setHeight().

qreal QSizeF::width () const

Retourne la largeur.

Voir aussi height() and setWidth().

QSizeF & QSizeF::operator*= ( qreal factor )

Il s'agit d'une fonction surcharg�e.

Multiplie les largeur et hauteur par la donn�e factor et retourne une r�f�rence � la taille.

Voir aussi scale().

QSizeF & QSizeF::operator+= ( const QSizeF & size )

Ajoute la taille size donn�e � cet objet et retourne une r�f�rence � cette taille. Par exemple :

 QSizeF s( 3, 7);
 QSizeF r(-1, 4);
 s += r;
 
 // s becomes (2,11)

QSizeF & QSizeF::operator-= ( const QSizeF & size )

Retire la taille size donn�e de cet objet et retourne une r�f�rence � cette taille. Par exemple :

 QSizeF s( 3, 7);
 QSizeF r(-1, 4);
 s -= r;
 
 // s becomes (4,3)

QSizeF & QSizeF::operator/= ( qreal divisor )

Il s'agit d'une fonction surcharg�e.

Divise les largeur et hauteur par le diviseur divisor donn� et retourne une r�f�rence � la nouvelle taille.

Voir aussi scale().

En relation mais non membres de la classe

bool operator!= ( const QSizeF & s1, const QSizeF & s2 )

Retourne true si s1 et s2 sont diff�rents ; sinon retourne false

const QSizeF operator* ( const QSizeF & size, qreal factor )

Il s'agit d'une fonction surcharg�e.

Multiplie la taille size par le facteur factor et retourne le r�sultat.

Voir aussi QSizeF::scale().

const QSizeF operator* ( qreal factor, const QSizeF & size )

Il s'agit d'une fonction surcharg�e.

Multiplie la taille size par le facteur factor et retourne le r�sultat.

const QSizeF operator+ ( const QSizeF & s1, const QSizeF & s2 )

Retourne la somme de s1 et s2 ; chaque composante est additionn�e s�par�ment.

const QSizeF operator- ( const QSizeF & s1, const QSizeF & s2 )

Retourne s2 soustrait � s1 ; chaque composante est soustraite s�par�ment.

const QSizeF operator/ ( const QSizeF & size, qreal divisor )

Il s'agit d'une fonction surcharg�e.

Divise la taille size par le diviseur divisor et retourne le r�sultat.

Voir aussi QSizeF::scale().

QDataStream & operator<< ( QDataStream & stream, const QSizeF & size )

�crit la taille size dans le flux stream et retourne une r�f�rence vers ce flux.

Voir aussi s�rialisation des type de donn�es Qt.

bool operator== ( const QSizeF & s1, const QSizeF & s2 )

Retourne true si s1 et s2 sont �gaux ; sinon, retourne false.

QDataStream & operator>> ( QDataStream & stream, QSizeF & size )

Lit la taille depuis le flux stream vers ‹size›› et retourne une r�f�rence vers le flux.

Voir aussi s�rialisation des type de donn�es Qt.

Remerciements

Merci � Jonathan Courtois pour la traduction et � Jacques Thery pour la relecture !