QSizeGrip Class
La classe QSizeGrip fournit une poignée de redimensionnement permettant de modifier la taille des fenêtres de premier niveau. En savoir plus...
| En-tête : | #include <QSizeGrip> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QWidget |
Fonctions publiques
| QSizeGrip(QWidget *parent) | |
| virtual | ~QSizeGrip() |
Fonctions publiques réimplémentées
| virtual void | setVisible(bool visible) override |
| virtual QSize | sizeHint() const override |
Fonctions protégées réimplémentées
| virtual bool | event(QEvent *event) override |
| virtual bool | eventFilter(QObject *o, QEvent *e) override |
| virtual void | hideEvent(QHideEvent *hideEvent) override |
| virtual void | mouseMoveEvent(QMouseEvent *event) override |
| virtual void | mousePressEvent(QMouseEvent *event) override |
| virtual void | mouseReleaseEvent(QMouseEvent *mouseEvent) override |
| virtual void | moveEvent(QMoveEvent *moveEvent) override |
| virtual void | paintEvent(QPaintEvent *event) override |
| virtual void | showEvent(QShowEvent *showEvent) override |
Description détaillée
Ce widget fonctionne comme la poignée de redimensionnement standard de Windows. Dans la version X11, cette poignée de redimensionnement fonctionne généralement différemment de celle fournie par le système si le gestionnaire de fenêtres X11 ne prend pas en charge les spécifications modernes post-ICCCM nécessaires.
Placez ce widget n'importe où dans une arborescence de widgets et l'utilisateur pourra l'utiliser pour redimensionner la fenêtre de niveau supérieur ou tout widget dont l'indicateur « Qt::SubWindow » est activé. En règle générale, il doit être placé dans le coin inférieur droit.
Notez que QStatusBar utilise déjà ce widget ; par conséquent, si vous disposez d’une barre d’état (par exemple, si vous utilisez QMainWindow), vous n’avez pas besoin d’utiliser explicitement ce widget. Il en va de même pour QDialog, pour lequel il suffit d’appeler QDialog::setSizeGripEnabled().
Sur certaines plateformes, la poignée de redimensionnement se masque automatiquement lorsque la fenêtre est affichée en plein écran ou agrandie.
Remarque : sous macOS, les poignées de redimensionnement ne font plus partie des directives d’interface utilisateur et ne s’affichent pas à moins d’être utilisées dans un QMdiSubWindow. Définissez un autre style pour les poignées de redimensionnement que vous souhaitez voir apparaître dans les fenêtres principales.
Un widget de poignée de redimensionnement situé dans le coin inférieur droit d’une fenêtre principale, affiché avec le style de widget « Fusion ».
La classe `QSizeGrip` hérite de ` QWidget ` et réimplémente les fonctions ` mousePressEvent()` et ` mouseMoveEvent()` pour offrir la fonctionnalité de redimensionnement, ainsi que la fonction ` paintEvent()` pour afficher le widget de poignée de redimensionnement.
Voir également QStatusBar et QWidget::windowState().
Documentation des fonctions membres
[explicit] QSizeGrip::QSizeGrip(QWidget *parent)
Crée un coin de redimensionnement en tant que widget enfant de l'parent donné.
[virtual noexcept] QSizeGrip::~QSizeGrip()
Détruit cette poignée de cette taille.
[override virtual protected] bool QSizeGrip::event(QEvent *event)
Réimplémente : QWidget::event(QEvent *event).
[override virtual protected] bool QSizeGrip::eventFilter(QObject *o, QEvent *e)
Réimplémente : QObject::eventFilter(QObject *watched, QEvent *event).
[override virtual protected] void QSizeGrip::hideEvent(QHideEvent *hideEvent)
Réimplémente : QWidget::hideEvent(QHideEvent *event).
[override virtual protected] void QSizeGrip::mouseMoveEvent(QMouseEvent *event)
Réimplémente : QWidget::mouseMoveEvent(QMouseEvent *event).
Redimensionne le widget de niveau supérieur contenant ce widget. L'événement de déplacement de la souris est transmis via le paramètre event.
[override virtual protected] void QSizeGrip::mousePressEvent(QMouseEvent *event)
Réimplémente : QWidget::mousePressEvent(QMouseEvent *event).
Reçoit les événements de clic de souris pour le widget et prépare l'opération de redimensionnement. L'événement de clic de souris est transmis via le paramètre event.
[override virtual protected] void QSizeGrip::mouseReleaseEvent(QMouseEvent *mouseEvent)
Réimplémente : QWidget::mouseReleaseEvent(QMouseEvent *event).
[override virtual protected] void QSizeGrip::moveEvent(QMoveEvent *moveEvent)
Réimplémente : QWidget::moveEvent(QMoveEvent *event).
[override virtual protected] void QSizeGrip::paintEvent(QPaintEvent *event)
Réimplémente : QWidget::paintEvent(QPaintEvent *event).
Dessine la poignée de redimensionnement.
Les poignées de redimensionnement sont généralement représentées sous la forme de petites lignes diagonales texturées dans le coin inférieur droit. L'événement de dessin est transmis via le paramètre event.
[override virtual] void QSizeGrip::setVisible(bool visible)
Réimplémente une fonction d'accès pour la propriété : QWidget::visible.
[override virtual protected] void QSizeGrip::showEvent(QShowEvent *showEvent)
Réimplémente : QWidget::showEvent(QShowEvent *event).
[override virtual] QSize QSizeGrip::sizeHint() const
Réimplémente une fonction d'accès pour la propriété : QWidget::sizeHint.
© 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.
