QSizeGrip Class
La classe QSizeGrip fournit une poignée de redimensionnement pour redimensionner les fenêtres de niveau supérieur. Plus d'informations...
| En-tête : | #include <QSizeGrip> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | 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 peut l'utiliser pour redimensionner la fenêtre de niveau supérieur ou tout widget ayant le drapeau Qt::SubWindow activé. En général, ce widget devrait se trouver dans le coin inférieur droit.
Notez que QStatusBar utilise déjà ce widget, donc si vous avez une barre d'état (par exemple, si vous utilisez QMainWindow), vous n'avez pas besoin d'utiliser ce widget explicitement. Il en va de même pour QDialog, pour lequel vous pouvez simplement appeler QDialog::setSizeGripEnabled().
Sur certaines plateformes, la poignée de taille se cache automatiquement lorsque la fenêtre est affichée en plein écran ou maximisée.
Remarque : sur macOS, les poignées de taille ne font plus partie des lignes directrices de l'interface humaine et ne s'affichent pas à moins d'être utilisées dans une fenêtre principale ( QMdiSubWindow). Définissez un autre style pour les poignées de taille que vous souhaitez voir apparaître dans les fenêtres principales.
Un widget de poignée de taille dans le coin inférieur droit d'une fenêtre principale, présenté dans le style de widget Fusion.
La classe QSizeGrip hérite de QWidget et réimplante les fonctions mousePressEvent() et mouseMoveEvent() pour la fonctionnalité de redimensionnement, ainsi que la fonction paintEvent() pour le rendu du widget de la poignée de taille.
Voir également QStatusBar et QWidget::windowState().
Documentation des fonctions membres
[explicit] QSizeGrip::QSizeGrip(QWidget *parent)
Construit un coin de redimensionnement en tant que widget enfant du widget donné parent.
[virtual noexcept] QSizeGrip::~QSizeGrip()
Détruit la prise 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 dans 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 pression de la souris pour le widget et amorce l'opération de redimensionnement. L'événement de pression de la souris est transmis dans 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).
Peint la poignée de redimensionnement.
Les poignées de redimensionnement sont généralement représentées par de petites lignes texturées diagonales dans le coin inférieur droit. L'événement de peinture est transmis dans le paramètre event.
[override virtual] void QSizeGrip::setVisible(bool visible)
Réimplémente une fonction d'accès à 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 à 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.
