QSizeGrip Class
La clase QSizeGrip proporciona un manejador de cambio de tamaño para cambiar el tamaño de las ventanas de nivel superior. Más...
| Cabecera: | #include <QSizeGrip> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | QWidget |
Funciones Públicas
| QSizeGrip(QWidget *parent) | |
| virtual | ~QSizeGrip() |
Funciones públicas reimplementadas
| virtual void | setVisible(bool visible) override |
| virtual QSize | sizeHint() const override |
Funciones protegidas reimplementadas
| 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 |
Descripción detallada
Este widget funciona como el manejador de redimensionamiento estándar de Windows. En la versión X11 este manejador de redimensionado funciona generalmente de forma diferente al proporcionado por el sistema si el gestor de ventanas X11 no soporta las especificaciones modernas post-ICCCM necesarias.
Coloque este widget en cualquier lugar de un árbol de widgets y el usuario podrá utilizarlo para redimensionar la ventana de nivel superior o cualquier widget con la bandera Qt::SubWindow activada. Generalmente, debería estar en la esquina inferior derecha.
Tenga en cuenta que QStatusBar ya utiliza este widget, por lo que si tiene una barra de estado (por ejemplo, si utiliza QMainWindow), no necesita utilizar este widget explícitamente. Lo mismo ocurre con QDialog, para el que basta con llamar a QDialog::setSizeGripEnabled().
En algunas plataformas, el control de tamaño se oculta automáticamente cuando la ventana se muestra a pantalla completa o maximizada.
Nota: En macOS, los size grips ya no forman parte de las directrices de la interfaz humana, y no se mostrarán a menos que se utilicen en un QMdiSubWindow. Establece otro estilo en los size grips que quieras que sean visibles en las ventanas principales.
Un widget de agarre de tamaño en la esquina inferior derecha de una ventana principal, mostrado en el estilo de widget Fusion.
La clase QSizeGrip hereda QWidget y reimplementa las funciones mousePressEvent() y mouseMoveEvent() para presentar la funcionalidad de redimensionamiento, y la función paintEvent() para renderizar el widget de agarre de tamaño.
Véase también QStatusBar y QWidget::windowState().
Documentación de las funciones miembro
[explicit] QSizeGrip::QSizeGrip(QWidget *parent)
Construye una esquina de redimensionamiento como widget hijo del widget parent.
[virtual noexcept] QSizeGrip::~QSizeGrip()
Destruye el agarre de este tamaño.
[override virtual protected] bool QSizeGrip::event(QEvent *event)
Reimplementa: QWidget::event(QEvent *event).
[override virtual protected] bool QSizeGrip::eventFilter(QObject *o, QEvent *e)
Reimplementa: QObject::eventFilter(QObject *watched, QEvent *event).
[override virtual protected] void QSizeGrip::hideEvent(QHideEvent *hideEvent)
Reimplementa: QWidget::hideEvent(QHideEvent *event).
[override virtual protected] void QSizeGrip::mouseMoveEvent(QMouseEvent *event)
Reimplementa: QWidget::mouseMoveEvent(QMouseEvent *event).
Redimensiona el widget de nivel superior que contiene este widget. El evento de movimiento del ratón se pasa en el parámetro event.
[override virtual protected] void QSizeGrip::mousePressEvent(QMouseEvent *event)
Reimplementa: QWidget::mousePressEvent(QMouseEvent *event).
Recibe los eventos de pulsación del ratón para el widget, y prepara la operación de redimensionado. El evento de pulsación del ratón se pasa en el parámetro event.
[override virtual protected] void QSizeGrip::mouseReleaseEvent(QMouseEvent *mouseEvent)
Reimplementa: QWidget::mouseReleaseEvent(QMouseEvent *event).
[override virtual protected] void QSizeGrip::moveEvent(QMoveEvent *moveEvent)
Reimplementa: QWidget::moveEvent(QMoveEvent *event).
[override virtual protected] void QSizeGrip::paintEvent(QPaintEvent *event)
Reimplementa: QWidget::paintEvent(QPaintEvent *event).
Pinta el agarre de redimensionado.
Los agarres de redimensionamiento se representan normalmente como pequeñas líneas diagonales texturizadas en la esquina inferior derecha. El evento de pintura se pasa en el parámetro event.
[override virtual] void QSizeGrip::setVisible(bool visible)
Reimplementa una función de acceso para la propiedad: QWidget::visible.
[override virtual protected] void QSizeGrip::showEvent(QShowEvent *showEvent)
Reimplementa: QWidget::showEvent(QShowEvent *event).
[override virtual] QSize QSizeGrip::sizeHint() const
Reimplementa una función de acceso para la propiedad: 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.
