Qt Reference Documentation

QSizeGrip Class Reference

The QSizeGrip class provides a resize handle for resizing top-level windows. More...

 #include <QSizeGrip>

Inherits QWidget.

Public Functions

QSizeGrip ( QWidget * parent )
~QSizeGrip ()

Reimplemented Public Functions

virtual void setVisible ( bool visible )
virtual QSize sizeHint () const
  • 217 public functions inherited from QWidget
  • 29 public functions inherited from QObject
  • 13 public functions inherited from QPaintDevice

Reimplemented Protected Functions

virtual bool event ( QEvent * event )
virtual bool eventFilter ( QObject * o, QEvent * e )
virtual void hideEvent ( QHideEvent * hideEvent )
virtual void mouseMoveEvent ( QMouseEvent * event )
virtual void mousePressEvent ( QMouseEvent * event )
virtual void mouseReleaseEvent ( QMouseEvent * mouseEvent )
virtual void moveEvent ( QMoveEvent * moveEvent )
virtual void paintEvent ( QPaintEvent * event )
virtual void showEvent ( QShowEvent * showEvent )
virtual bool winEvent ( MSG * m, long * result )
  • 37 protected functions inherited from QWidget
  • 7 protected functions inherited from QObject
  • 1 protected function inherited from QPaintDevice

Additional Inherited Members

  • 58 properties inherited from QWidget
  • 1 property inherited from QObject
  • 19 public slots inherited from QWidget
  • 1 public slot inherited from QObject
  • 1 signal inherited from QWidget
  • 1 signal inherited from QObject
  • 4 static public members inherited from QWidget
  • 5 static public members inherited from QObject
  • 37 protected functions inherited from QWidget
  • 7 protected functions inherited from QObject
  • 1 protected function inherited from QPaintDevice
  • 1 protected slot inherited from QWidget

Detailed Description

The QSizeGrip class provides a resize handle for resizing top-level windows.

This widget works like the standard Windows resize handle. In the X11 version this resize handle generally works differently from the one provided by the system if the X11 window manager does not support necessary modern post-ICCCM specifications.

Put this widget anywhere in a widget tree and the user can use it to resize the top-level window or any widget with the Qt::SubWindow flag set. Generally, this should be in the lower right-hand corner. Note that QStatusBar already uses this widget, so if you have a status bar (e.g., you are using QMainWindow), then you don't need to use this widget explicitly.

On some platforms the size grip automatically hides itself when the window is shown full screen or maximised.

Screenshot of a Plastique style size grip

A size grip widget at the bottom-right corner of a main window, shown in the Plastique widget style.

The QSizeGrip class inherits QWidget and reimplements the mousePressEvent() and mouseMoveEvent() functions to feature the resize functionality, and the paintEvent() function to render the size grip widget.

See also QStatusBar and QWidget::windowState().

Member Function Documentation

QSizeGrip::QSizeGrip ( QWidget * parent )

Constructs a resize corner as a child widget of the given parent.

QSizeGrip::~QSizeGrip ()

Destroys this size grip.

bool QSizeGrip::event ( QEvent * event ) [virtual protected]

Reimplemented from QObject::event().

bool QSizeGrip::eventFilter ( QObject * o, QEvent * e ) [virtual protected]

Reimplemented from QObject::eventFilter().

void QSizeGrip::hideEvent ( QHideEvent * hideEvent ) [virtual protected]

Reimplemented from QWidget::hideEvent().

void QSizeGrip::mouseMoveEvent ( QMouseEvent * event ) [virtual protected]

Reimplemented from QWidget::mouseMoveEvent().

Resizes the top-level widget containing this widget. The mouse move event is passed in the event parameter.

void QSizeGrip::mousePressEvent ( QMouseEvent * event ) [virtual protected]

Reimplemented from QWidget::mousePressEvent().

Receives the mouse press events for the widget, and primes the resize operation. The mouse press event is passed in the event parameter.

void QSizeGrip::mouseReleaseEvent ( QMouseEvent * mouseEvent ) [virtual protected]

Reimplemented from QWidget::mouseReleaseEvent().

void QSizeGrip::moveEvent ( QMoveEvent * moveEvent ) [virtual protected]

Reimplemented from QWidget::moveEvent().

void QSizeGrip::paintEvent ( QPaintEvent * event ) [virtual protected]

Reimplemented from QWidget::paintEvent().

Paints the resize grip.

Resize grips are usually rendered as small diagonal textured lines in the lower-right corner. The paint event is passed in the event parameter.

void QSizeGrip::setVisible ( bool visible ) [virtual]

Reimplemented from QWidget::setVisible().

void QSizeGrip::showEvent ( QShowEvent * showEvent ) [virtual protected]

Reimplemented from QWidget::showEvent().

QSize QSizeGrip::sizeHint () const [virtual]

Reimplemented from QWidget::sizeHint().

bool QSizeGrip::winEvent ( MSG * m, long * result ) [virtual protected]

Reimplemented from QWidget::winEvent().

X

Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.