Sur cette page

QSpacerItem Class

La classe QSpacerItem fournit des espaces vides dans une mise en page. Plus d'informations...

En-tête : #include <QSpacerItem>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Héritages : 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

Normalement, vous n'avez pas besoin d'utiliser cette classe directement. Les gestionnaires de disposition intégrés de Qt fournissent les fonctions suivantes pour manipuler les espaces vides dans les dispositions :

Voir également QLayout, QWidgetItem, et QLayoutItem::spacerItem().

Documentation sur les fonctions membres

QSpacerItem::QSpacerItem(int w, int h, QSizePolicy::Policy hPolicy = QSizePolicy::Minimum, QSizePolicy::Policy vPolicy = QSizePolicy::Minimum)

Construit un élément d'espacement avec la largeur préférée w, la hauteur préférée h, la politique de taille horizontale hPolicy et la politique de taille verticale vPolicy.

Les valeurs par défaut permettent de créer un espace capable de s'étirer si rien d'autre n'occupe l'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 qu'il ait une largeur préférentielle w, une hauteur préférentielle h, une politique de taille horizontale hPolicy et une politique de taille verticale vPolicy.

Les valeurs par défaut permettent de créer un espace qui peut s'étirer si rien d'autre n'occupe l'espace.

Notez que si changeSize() est appelé après que l'élément d'espacement a été ajouté à 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 également setGeometry().

[override virtual] bool QSpacerItem::isEmpty() const

Réimplémente : QLayoutItem::isEmpty() const.

Retourne 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 sur 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.