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 !