QSize Class

Documentation des fonctions membres

[constexpr noexcept] QSize::QSize()

Crée un objet « size » dont la largeur et la hauteur ne sont pas valides (c'est-à-dire que la fonction ` isValid()` renvoie ` false`).

Voir également isValid().

[constexpr noexcept] QSize::QSize(int width, int height)

Crée un objet de taille à partir des paramètres ` width ` et ` height` fournis.

Voir également setWidth() et setHeight().

[constexpr noexcept] QSize QSize::boundedTo(const QSize &otherSize) const

Renvoie un objet « size » contenant la largeur et la hauteur minimales de cet objet « size » et de l'objet « otherSize » fourni.

Voir également ` expandedTo()` et ` scale()`.

[constexpr noexcept] QSize QSize::expandedTo(const QSize &otherSize) const

Renvoie un objet « size » contenant la largeur et la hauteur maximales de cet objet « size » et de l’objet « otherSize » fourni.

Voir également ` boundedTo()` et ` scale()`.

[constexpr noexcept] QSize QSize::grownBy(QMargins margins) const

Renvoie la taille obtenue en augmentant cette taille de margins.

Voir aussi ` shrunkBy()`.

[constexpr noexcept] int QSize::height() const

Renvoie la hauteur.

Voir également width() et setHeight().

[constexpr noexcept] bool QSize::isEmpty() const

Renvoie true si la largeur ou la hauteur est inférieure ou égale à 0 ; sinon, renvoie false.

Voir également isNull() et isValid().

[constexpr noexcept] bool QSize::isNull() const

Renvoie « true » si la largeur et la hauteur sont toutes deux égales à 0 ; sinon, renvoie « false ».

Voir également isValid() et isEmpty().

[constexpr noexcept] bool QSize::isValid() const

Renvoie « true » si la largeur et la hauteur sont toutes deux égales ou supérieures à 0 ; sinon, renvoie « false ».

Voir également isNull() et isEmpty().

[constexpr noexcept] int &QSize::rheight()

Renvoie une référence à la hauteur.

L'utilisation d'une référence permet de manipuler directement la hauteur. Par exemple :

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

// size becomes (100,15)

Voir également rwidth() et setHeight().

[constexpr noexcept] int &QSize::rwidth()

Renvoie une référence à la largeur.

L'utilisation d'une référence permet de manipuler directement la largeur. Par exemple :

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

// size becomes (120,10)

Voir également rheight() et setWidth().

[noexcept] void QSize::scale(int width, int height, Qt::AspectRatioMode mode)

Redimensionne l'image en un rectangle dont les dimensions sont définies par les paramètres « width » et « height », conformément à la valeur spécifiée pour « mode » :

• Si mode est égal à Qt::IgnoreAspectRatio, la taille est définie sur (width, height).
• Si ` mode ` est ` Qt::KeepAspectRatio`, la taille actuelle est mise à l’échelle pour former un rectangle aussi grand que possible à l’intérieur de `(width, height)`, en conservant le rapport d’aspect.
• Si mode vaut Qt::KeepAspectRatioByExpanding, la taille actuelle est redimensionnée pour former un rectangle aussi petit que possible à l’extérieur (width, height), tout en conservant le rapport d’aspect.

Exemple :

QSize t1(10, 12);
t1.scale(60, 60, Qt::IgnoreAspectRatio);
// t1 is (60, 60)

QSize t2(10, 12);
t2.scale(60, 60, Qt::KeepAspectRatio);
// t2 is (50, 60)

QSize t3(10, 12);
t3.scale(60, 60, Qt::KeepAspectRatioByExpanding);
// t3 is (60, 72)

Voir également ` setWidth()`, ` setHeight()` et ` scaled()`.

[noexcept] void QSize::scale(const QSize &size, Qt::AspectRatioMode mode)

Redimensionne l'image en un rectangle aux dimensions size, selon le mode spécifié.

[noexcept] QSize QSize::scaled(int width, int height, Qt::AspectRatioMode mode) const

Renvoie un rectangle dont la taille est adaptée aux dimensions width et height, conformément à la mode spécifiée.

Voir également scale().

[noexcept] QSize QSize::scaled(const QSize &s, Qt::AspectRatioMode mode) const

Renvoie un rectangle dont les dimensions sont adaptées à celles spécifiées par ` s`, conformément à la méthode ` mode` indiquée.

[constexpr noexcept] void QSize::setHeight(int height)

Définit la hauteur sur la valeur indiquée height.

Voir également rheight(), height() et setWidth().

[constexpr noexcept] void QSize::setWidth(int width)

Définit la largeur sur la valeur indiquée dans width.

Voir également rwidth(), width() et setHeight().

[constexpr noexcept] QSize QSize::shrunkBy(QMargins margins) const

Renvoie la taille obtenue en réduisant cette taille de margins.

Voir aussi ` grownBy()`.

[noexcept] CGSize QSize::toCGSize() const

Crée un objet `CGSize` à partir d'un objet ` QSize`.

Voir aussi QSizeF::fromCGSize().

[constexpr noexcept, since 6.4] QSizeF QSize::toSizeF() const

Renvoie cette taille sous forme de valeur à virgule flottante.

Cette fonction a été introduite dans Qt 6.4.

Voir également ` QSizeF::toSize()`.

[noexcept] void QSize::transpose()

Permute les valeurs de largeur et de hauteur.

Voir également setWidth(), setHeight() et transposed().

[constexpr noexcept] QSize QSize::transposed() const

Renvoie un objet ` QSize ` dont la largeur et la hauteur sont inversées.

Voir aussi transpose().

[constexpr noexcept] int QSize::width() const

Renvoie la largeur.

Voir aussi height() et setWidth().

[constexpr noexcept] QSize &QSize::operator*=(qreal factor)

Multiplie à la fois la largeur et la hauteur par l'factor e indiquée, puis renvoie une référence à la taille obtenue.

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

Voir aussi ` scale()`.

[constexpr noexcept] QSize &QSize::operator+=(const QSize &size)

Ajoute l'size on indiquée à cette taille et renvoie une référence à cette taille. Par exemple :

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

// s becomes (2,11)

[constexpr noexcept] QSize &QSize::operator-=(const QSize &size)

Soustrait l'size e spécifiée de cette taille et renvoie une référence à cette taille. Par exemple :

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

// s becomes (4,3)

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

Divise à la fois la largeur et la hauteur par l'divisor e spécifiée, puis renvoie une référence à la taille obtenue.

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

Voir également ` QSize::scale()`.