QSize Class

Documentation des fonctions membres

[constexpr noexcept] QSize::QSize()

Construit une taille avec une largeur et une hauteur non valides (c'est-à-dire que isValid() renvoie false).

Voir aussi isValid().

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

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

Voir aussi setWidth() et setHeight().

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

Renvoie une taille contenant la largeur et la hauteur minimales de cette taille et de l'adresse otherSize.

Voir aussi expandedTo() et scale().

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

Renvoie une taille contenant la largeur et la hauteur maximales de cette taille et de l'adresse otherSize.

Voir aussi boundedTo() et scale().

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

Renvoie la taille qui résulte de l'augmentation de cette taille par margins.

Voir aussi shrunkBy().

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

Renvoie la hauteur.

Voir aussi width() et setHeight().

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

Renvoie true si la largeur et la hauteur sont inférieures ou égales à 0 ; sinon, renvoie false.

Voir aussi 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 aussi isValid() et isEmpty().

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

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

Voir aussi 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. A titre d'exemple :

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

// size becomes (100,15)

Voir aussi 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, l'utilisation d'une référence permet de manipuler directement la largeur :

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

// size becomes (120,10)

Voir aussi rheight() et setWidth().

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

Redimensionne la taille d'un rectangle avec les adresses width et height, en fonction de l'adresse mode:

• Si mode est Qt::IgnoreAspectRatio, la taille est fixée à (width, height).
• Si mode est Qt::KeepAspectRatio, la taille actuelle est mise à l'échelle pour obtenir un rectangle aussi grand que possible à l'intérieur de (width, height), en préservant le rapport d'aspect.
• Si mode est Qt::KeepAspectRatioByExpanding, la taille actuelle est réduite à un rectangle aussi petit que possible à l'extérieur de (width, height), en préservant le rapport hauteur/largeur.

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)

Met à l'échelle la taille d'un rectangle avec l'adresse size, en fonction de l'adresse mode spécifiée.

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

Renvoie une taille adaptée à un rectangle avec les données width et height, en fonction de la taille spécifiée mode.

Voir aussi scale().

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

Renvoie une taille mise à l'échelle d'un rectangle de la taille donnée s, en fonction de la taille spécifiée mode.

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

Fixe la hauteur à la valeur donnée height.

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

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

Fixe la largeur à la valeur donnée width.

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

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

Renvoie la taille qui résulte de la réduction de cette taille par margins.

Voir aussi grownBy().

[noexcept] CGSize QSize::toCGSize() const

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

Voir aussi QSizeF::fromCGSize().

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

Renvoie cette taille en tant que taille avec une précision en virgule flottante.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi QSizeF::toSize().

[noexcept] void QSize::transpose()

Intervertit les valeurs de largeur et de hauteur.

Voir aussi setWidth(), setHeight() et transposed().

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

Renvoie une page QSize dont la largeur et la hauteur ont été interverties.

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 largeur et la hauteur par factor, et renvoie une référence à la taille.

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

Voir aussi scale().

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

Ajoute la valeur size à 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 la valeur size 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 largeur et la hauteur par divisor, et renvoie une référence à la taille.

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

Voir également QSize::scale().