QSize

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

 #include <QSize>

Description d�taill�e

La classe QSize d�finit la taille d'un objet bidimensionnel en utilisant des points � pr�cision enti�re.

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.

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

Voir aussi QSizeF, QPoint et QRect.

Fonctions membres

QSize::QSize ()

Construit une taille avec une largeur et hauteur invalide (c'est-�-dire que isValid() retourne false).

Voir aussi isValid().

QSize::QSize ( int width, int height )

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

Voir aussi setWidth() et setHeight().

QSize QSize::boundedTo ( const QSize & otherSize ) const

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

Voir aussi expandedTo() et scale().

QSize QSize::expandedTo ( const QSize & otherSize ) const

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

Voir aussi boundedTo() et scale().

int QSize::height () const

Retourne la hauteur.

Voir aussi width() et setHeight().

bool QSize::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 QSize::isNull () const

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

Voir aussi isValid() et isEmpty().

bool QSize::isValid () const

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

Voir aussi isNull() et isEmpty().

int & QSize::rheight ()

Retourne une r�f�rence � la hauteur.

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

 QSize size(100, 10);
 size.rheight() += 5;
 
 // size devient (100,15)

Voir aussi rwidth() et setHeight().

int & QSize::rwidth ()

Retourne une r�f�rence � la largeur.

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

 QSize size(100, 10);
 size.rwidth() += 20;
 
 // size devient (120,10)

Voir aussi rheight() et setWidth().

void QSize::scale ( int width, int 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 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 :

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

Voir aussi setWidth() et setHeight().

void QSize::scale ( const QSize & 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 QSize::setHeight ( int height )

D�finit la hauteur � height.

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

void QSize::setWidth ( int width )

D�finit la largeur � width.

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

void QSize::transpose ()

�change les valeurs des largeur et hauteur.

Voir aussi setWidth() et setHeight().

int QSize::width () const

Retourne la largeur.

Voir aussi height() et setWidth().

QSize & QSize::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.

Notez que le r�sultat est arrondi � l'entier le proche.

Voir aussi scale().

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

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

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

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

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

 QSize s( 3, 7);
 QSize r(-1, 4);
 s -= r;
 
 // s devient (4,3)

QSize & QSize::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.

Notez que le r�sultat est arrondi � l'entier le plus proche.

Voir aussi QSize::scale().

En relation mais non membres de la classe

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

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

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

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

Multiplie la taille size par le facteur factor et retourne le r�sultat arrondi � l'entier le plus proche.

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

Multiplie la taille size par le facteur factor et retourne le r�sultat arrondi � l'entier le plus proche.

Voir aussi QSize::scale().

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

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

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

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

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

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

Divise la taille size par le diviseur divisor et retourne le r�sultat arrondi � l'entier le plus proche.

Voir aussi QSize::scale().

QDataStream & operator<< ( QDataStream & stream, const QSize & 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 QSize & s1, const QSize & s2 )

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

QDataStream & operator>> ( QDataStream & stream, QSize & 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 � Abdelhafid Hafidi pour la traduction, ainsi qu'� Thibaut Cuvelier, Jonathan Courtois et Jacques Thery pour leur relecture !