QSizeGrip Class Reference
^{[QtGui module]}

Detailed Description

The QSizeGrip class provides a corner-grip for resizing a top-level window.

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; we hope to reduce this difference in the future.

Put this widget anywhere in a widget tree and the user can use it to resize the top-level window. 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 sizegrip automatically hides itself when the window is shown full screen or maximised.

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 sizegrip 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.

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

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

Reimplemented from QWidget.

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

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

Reimplemented from QWidget.

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

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.

Reimplemented from QWidget.

Member Function Documentation

QSizeGrip::QSizeGrip ( QWidget * parent, const char * name )

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