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 !