En esta página

QSizeGrip Class

La clase QSizeGrip proporciona un controlador de redimensionamiento para cambiar el tamaño de las ventanas de nivel superior. Más información...

Encabezado: #include <QSizeGrip>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: 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 controlador de redimensionamiento estándar de Windows. En la versión para X11, este controlador de redimensionamiento suele funcionar de forma diferente al proporcionado por el sistema si el gestor de ventanas de X11 no es compatible con las especificaciones modernas posteriores a ICCCM necesarias.

Coloca este widget en cualquier lugar del árbol de widgets y el usuario podrá utilizarlo para cambiar el tamaño de la ventana de nivel superior o de cualquier widget que tenga activada la bandera « Qt::SubWindow ». Por lo general, debería situarse en la esquina inferior derecha.

Ten en cuenta que QStatusBar ya utiliza este widget, por lo que si tienes una barra de estado (por ejemplo, si estás utilizando QMainWindow), no es necesario que utilices este widget de forma explícita. Lo mismo ocurre con QDialog, para lo cual basta con llamar a QDialog::setSizeGripEnabled().

En algunas plataformas, el controlador de tamaño se oculta automáticamente cuando la ventana se muestra a pantalla completa o maximizada.

Nota: En macOS, los controles de tamaño ya no forman parte de las directrices de interfaz de usuario y no se mostrarán a menos que se utilicen en un QMdiSubWindow. Establece otro estilo para los controles de tamaño que desees que sean visibles en las ventanas principales.

Botón de tamaño en la esquina inferior derecha

Un control de tamaño en la esquina inferior derecha de una ventana principal, mostrado con el estilo de widget «Fusion».

La clase `QSizeGrip` hereda de ` QWidget ` y reimplementa las funciones ` mousePressEvent()` y ` mouseMoveEvent()` para ofrecer la funcionalidad de cambio de tamaño, así como la función ` paintEvent()` para renderizar el widget de control de tamaño.

Véase también QStatusBar y QWidget::windowState().

Documentación de las funciones de miembro

[explicit] QSizeGrip::QSizeGrip(QWidget *parent)

Crea una esquina de redimensionamiento como widget secundario del ` parent` especificado.

[virtual noexcept] QSizeGrip::~QSizeGrip()

Destruye este 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)`.

Cambia el tamaño del 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 correspondientes al widget y prepara la operación de cambio de tamaño. El evento de pulsación del ratón se pasa a través del 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).

Dibuja el controlador de redimensionamiento.

Los controladores de redimensionamiento suelen representarse como pequeñas líneas diagonales con textura en la esquina inferior derecha. El evento de dibujo 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.