QSpacerItem Class
La classe QSpacerItem permet d'insérer un espace vide dans une mise en page. En savoir plus...
| En-tête : | #include <QSpacerItem> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QLayoutItem |
Fonctions publiques
| QSpacerItem(int w, int h, QSizePolicy::Policy hPolicy = QSizePolicy::Minimum, QSizePolicy::Policy vPolicy = QSizePolicy::Minimum) | |
| virtual | ~QSpacerItem() |
| void | changeSize(int w, int h, QSizePolicy::Policy hPolicy = QSizePolicy::Minimum, QSizePolicy::Policy vPolicy = QSizePolicy::Minimum) |
| QSizePolicy | sizePolicy() const |
Fonctions publiques réimplémentées
| virtual Qt::Orientations | expandingDirections() const override |
| virtual QRect | geometry() const override |
| virtual bool | isEmpty() const override |
| virtual QSize | maximumSize() const override |
| virtual QSize | minimumSize() const override |
| virtual void | setGeometry(const QRect &r) override |
| virtual QSize | sizeHint() const override |
| virtual QSpacerItem * | spacerItem() override |
Description détaillée
En règle générale, vous n’avez pas besoin d’utiliser cette classe directement. Les gestionnaires de mise en page intégrés à Qt fournissent les fonctions suivantes pour manipuler les espaces vides dans les mises en page :
| Classe | Fonctions |
|---|---|
| QHBoxLayout | addSpacing(), addStretch(), insertSpacing(), insertStretch() |
| QGridLayout | setRowMinimumHeight(), setRowStretch(), setColumnMinimumWidth(), setColumnStretch() |
Voir également QLayout, QWidgetItem et QLayoutItem::spacerItem().
Documentation des fonctions membres
QSpacerItem::QSpacerItem(int w, int h, QSizePolicy::Policy hPolicy = QSizePolicy::Minimum, QSizePolicy::Policy vPolicy = QSizePolicy::Minimum)
Crée un élément d'espacement avec une largeur préférentielle w, une hauteur préférentielle h, une politique de dimensionnement horizontal hPolicy et une politique de dimensionnement vertical vPolicy.
Les valeurs par défaut créent un espace capable de s'étirer si aucun autre élément ne revendique cet espace.
[virtual noexcept] QSpacerItem::~QSpacerItem()
Destructeur.
void QSpacerItem::changeSize(int w, int h, QSizePolicy::Policy hPolicy = QSizePolicy::Minimum, QSizePolicy::Policy vPolicy = QSizePolicy::Minimum)
Modifie cet élément d'espacement pour lui attribuer une largeur préférentielle w, une hauteur préférentielle h, une politique de dimensionnement horizontal hPolicy et une politique de dimensionnement vertical vPolicy.
Les valeurs par défaut créent un espace capable de s’étirer si aucun autre élément ne revendique cet espace.
Notez que si la méthode changeSize() est appelée après l’ajout de l’élément d’espacement à une mise en page, il est nécessaire d’invalider la mise en page pour que la nouvelle taille de l’élément d’espacement prenne effet.
Voir également QSpacerItem::invalidate().
[override virtual] Qt::Orientations QSpacerItem::expandingDirections() const
Réimplémente : QLayoutItem::expandingDirections() const.
[override virtual] QRect QSpacerItem::geometry() const
Réimplémente : QLayoutItem::geometry() const.
Voir aussi setGeometry().
[override virtual] bool QSpacerItem::isEmpty() const
Réimplémente : QLayoutItem::isEmpty() const.
Renvoie true.
[override virtual] QSize QSpacerItem::maximumSize() const
Réimplémente : QLayoutItem::maximumSize() const.
[override virtual] QSize QSpacerItem::minimumSize() const
Réimplémente : QLayoutItem::minimumSize() const.
[override virtual] void QSpacerItem::setGeometry(const QRect &r)
Réimplémente : QLayoutItem::setGeometry(const QRect &r).
Voir également geometry().
[override virtual] QSize QSpacerItem::sizeHint() const
Réimplémente : QLayoutItem::sizeHint() const.
QSizePolicy QSpacerItem::sizePolicy() const
Renvoie la politique de taille de cet élément.
[override virtual] QSpacerItem *QSpacerItem::spacerItem()
Réimplémente : QLayoutItem::spacerItem().
Renvoie un pointeur vers cet objet.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
