QSizeGrip Class
Die Klasse „QSizeGrip“ stellt einen Griff zur Größenänderung von Fenstern der obersten Ebene bereit. Mehr...
| Header: | #include <QSizeGrip> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QWidget |
Öffentliche Funktionen
| QSizeGrip(QWidget *parent) | |
| virtual | ~QSizeGrip() |
Neu implementierte öffentliche Funktionen
| virtual void | setVisible(bool visible) override |
| virtual QSize | sizeHint() const override |
Neu implementierte geschützte Funktionen
| 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 |
Ausführliche Beschreibung
Dieses Widget funktioniert wie der standardmäßige Windows-Griff zum Ändern der Größe. In der X11-Version funktioniert dieser Griff zum Ändern der Größe im Allgemeinen anders als der vom System bereitgestellte, wenn der X11-Fenstermanager die erforderlichen modernen Post-ICCCM-Spezifikationen nicht unterstützt.
Platzieren Sie dieses Widget an einer beliebigen Stelle im Widgetbaum, und der Benutzer kann damit die Größe des obersten Fensters oder jedes Widgets ändern, bei dem das Flag „ Qt::SubWindow “ gesetzt ist. In der Regel sollte sich dieses Widget in der unteren rechten Ecke befinden.
Beachten Sie, dass „ QStatusBar “ dieses Widget bereits verwendet. Wenn Sie also eine Statusleiste haben (z. B. wenn Sie ` QMainWindow` verwenden), müssen Sie dieses Widget nicht explizit einsetzen. Dasselbe gilt für ` QDialog`, für das Sie einfach ` QDialog::setSizeGripEnabled()` aufrufen können.
Auf einigen Plattformen wird der Größenregler automatisch ausgeblendet, wenn das Fenster im Vollbildmodus oder maximiert angezeigt wird.
Hinweis: Unter macOS sind Größenregler nicht mehr Bestandteil der Human Interface Guidelines und werden nur angezeigt, wenn sie in einem „ QMdiSubWindow “ verwendet werden. Legen Sie für Größenregler, die in Hauptfenstern sichtbar sein sollen, einen anderen Stil fest.
Ein Größengriff-Widget in der unteren rechten Ecke eines Hauptfensters, dargestellt im Fusion-Widget-Stil.
Die Klasse `QSizeGrip` erbt von ` QWidget ` und implementiert die Funktionen ` mousePressEvent()` und ` mouseMoveEvent()` neu, um die Größenänderungsfunktionalität bereitzustellen, sowie die Funktion ` paintEvent()`, um das Größenänderungs-Widget darzustellen.
Siehe auch „ QStatusBar “ und „ QWidget::windowState()“.
Dokumentation zu den Member-Funktionen
[explicit] QSizeGrip::QSizeGrip(QWidget *parent)
Erstellt eine Größenänderungs-Ecke als untergeordnetes Widget des angegebenen „ parent “.
[virtual noexcept] QSizeGrip::~QSizeGrip()
Zerstört diesen Griff dieser Größe.
[override virtual protected] bool QSizeGrip::event(QEvent *event)
Umsetzt: ` QWidget::event(QEvent *event)`.
[override virtual protected] bool QSizeGrip::eventFilter(QObject *o, QEvent *e)
Implementiert: QObject::eventFilter(QObject *watched, QEvent *event).
[override virtual protected] void QSizeGrip::hideEvent(QHideEvent *hideEvent)
Implementiert: ` QWidget::hideEvent(QHideEvent *event)`.
[override virtual protected] void QSizeGrip::mouseMoveEvent(QMouseEvent *event)
Implementiert: ` QWidget::mouseMoveEvent` (`QMouseEvent *event`).
Passen Sie die Größe des übergeordneten Widgets an, das dieses Widget enthält. Das Mausbewegungsereignis wird im Parameter „ event “ übergeben.
[override virtual protected] void QSizeGrip::mousePressEvent(QMouseEvent *event)
Umsetzt: ` QWidget::mousePressEvent` (`QMouseEvent *event`).
Empfängt die Mausklick-Ereignisse für das Widget und bereitet den Größenänderungsvorgang vor. Das Mausklick-Ereignis wird über den Parameter ` event ` übergeben.
[override virtual protected] void QSizeGrip::mouseReleaseEvent(QMouseEvent *mouseEvent)
Implementiert: ` QWidget::mouseReleaseEvent(QMouseEvent *event)`.
[override virtual protected] void QSizeGrip::moveEvent(QMoveEvent *moveEvent)
Implementiert: ` QWidget::moveEvent(QMoveEvent *event)`.
[override virtual protected] void QSizeGrip::paintEvent(QPaintEvent *event)
Umsetzt: QWidget::paintEvent(QPaintEvent *event).
Zeichnet den Griff zur Größenänderung.
Größenänderungsgriffe werden in der Regel als kleine, diagonal verlaufende, texturierte Linien in der unteren rechten Ecke dargestellt. Das Paint-Ereignis wird über den Parameter „ event “ übergeben.
[override virtual] void QSizeGrip::setVisible(bool visible)
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::visible “ neu.
[override virtual protected] void QSizeGrip::showEvent(QShowEvent *showEvent)
Implementiert: ` QWidget::showEvent(QShowEvent *event)`.
[override virtual] QSize QSizeGrip::sizeHint() const
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::sizeHint “ neu.
© 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.
