Q3DockWindowResizeHandle Class Reference

Inheritance diagram for Q3DockWindowResizeHandle:

[legend]Collaboration diagram for Q3DockWindowResizeHandle:

[legend]List of all members.

---

Detailed Description

Definition at line 56 of file q3dockwindow.cpp.

Public Member Functions
	Q3DockWindowResizeHandle (Qt::Orientation o, QWidget *parent, Q3DockWindow *w, const char *=0)
void	setOrientation (Qt::Orientation o)
Qt::Orientation	orientation () const
QSize	sizeHint () const
Protected Member Functions
void	paintEvent (QPaintEvent *)
void	mouseMoveEvent (QMouseEvent *)
void	mousePressEvent (QMouseEvent *)
void	mouseReleaseEvent (QMouseEvent *)
bool	event (QEvent *event)
Private Member Functions
void	startLineDraw ()
void	endLineDraw ()
void	drawLine (const QPoint &globalPos)
Private Attributes
Qt::Orientation	orient
bool	mousePressed
QRubberBand *	rubberBand
QPoint	lastPos
QPoint	firstPos
Q3DockWindow *	dockWindow
bool	mouseOver

---

Constructor & Destructor Documentation

Q3DockWindowResizeHandle::Q3DockWindowResizeHandle	(	Qt::Orientation	o,
		QWidget *	parent,
		Q3DockWindow *	w,
		const char *	= 0
	)

Definition at line 88 of file q3dockwindow.cpp.

References setOrientation().

    : QWidget(parent, "qt_dockwidget_internal"), mousePressed(false), rubberBand(0), dockWindow(w),
      mouseOver(false)
{
    setOrientation(o);
}

Here is the call graph for this function:

---

Member Function Documentation

void Q3DockWindowResizeHandle::setOrientation

(

Qt::Orientation

o

)

Definition at line 110 of file q3dockwindow.cpp.

References QSizePolicy::Expanding, QSizePolicy::Fixed, Qt::Horizontal, orient, QWidget::setCursor(), and QWidget::setSizePolicy().

Referenced by Q3DockWindowResizeHandle().

{
    orient = o;
    if (o == Qt::Horizontal) {
#ifndef QT_NO_CURSOR
        setCursor(Qt::splitVCursor);
#endif
        setSizePolicy(QSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed));
    } else {
#ifndef QT_NO_CURSOR
        setCursor(Qt::splitHCursor);
#endif
        setSizePolicy(QSizePolicy(QSizePolicy::Fixed, QSizePolicy::Expanding));
    }
}

Here is the call graph for this function:

Qt::Orientation Q3DockWindowResizeHandle::orientation

(

)

const [inline]

Definition at line 63 of file q3dockwindow.cpp.

References orient.

Referenced by drawLine(), mouseMoveEvent(), mouseReleaseEvent(), and paintEvent().

{ return orient; }

QSize Q3DockWindowResizeHandle::sizeHint

(

)

const [virtual]

Reimplemented from QWidget.

Definition at line 96 of file q3dockwindow.cpp.

References Q3DockWindow::area(), QStyleOptionQ3DockWindow::closeEnabled, QStyle::CT_Q3DockWindow, QStyleOptionQ3DockWindow::docked, dockWindow, QApplication::globalStrut(), Qt::Horizontal, QStyleOption::init(), Q3DockWindow::isCloseEnabled(), Q3DockArea::orientation(), QStyle::pixelMetric(), QStyle::PM_SplitterWidth, QStyleOption::rect, QWidget::rect(), QStyleOption::state, QStyle::State_Horizontal, and QWidget::style().

{
    QStyleOptionQ3DockWindow opt;
    opt.init(this);
    if (!dockWindow->area() || dockWindow->area()->orientation() == Qt::Horizontal)
        opt.state |= QStyle::State_Horizontal;

    opt.rect = rect();
    opt.docked = dockWindow->area();
    opt.closeEnabled = dockWindow->isCloseEnabled();
    int sw = 2 * style()->pixelMetric(QStyle::PM_SplitterWidth, &opt, this) / 3;
    return (style()->sizeFromContents(QStyle::CT_Q3DockWindow, &opt, QSize(sw, sw), this).expandedTo(QApplication::globalStrut()));
}

Here is the call graph for this function:

void Q3DockWindowResizeHandle::paintEvent

(

QPaintEvent *

)

[protected, virtual]

This event handler can be reimplemented in a subclass to receive paint events which are passed in the event parameter.

A paint event is a request to repaint all or part of the widget. It can happen as a result of repaint() or update(), or because the widget was obscured and has now been uncovered, or for many other reasons.

Many widgets can simply repaint their entire surface when asked to, but some slow widgets need to optimize by painting only the requested region: QPaintEvent::region(). This speed optimization does not change the result, as painting is clipped to that region during event processing. QListView and QTableView do this, for example.

Qt also tries to speed up painting by merging multiple paint events into one. When update() is called several times or the window system sends several paint events, Qt merges these events into one event with a larger region (see QRegion::united()). repaint() does not permit this optimization, so we suggest using update() whenever possible.

When the paint event occurs, the update region has normally been erased, so that you're painting on the widget's background.

The background can be set using setBackgroundRole() and setPalette().

From Qt 4.0, QWidget automatically double-buffers its painting, so there's no need to write double-buffering code in paintEvent() to avoid flicker.

Note: Under X11 it is possible to toggle the global double buffering by calling qt_x11_set_global_double_buffer(). Example usage:

    ...
    extern void qt_x11_set_global_double_buffer(bool);
    qt_x11_set_global_double_buffer(false);
    ...

See also:

event(), repaint(), update(), QPainter, QPixmap, QPaintEvent, {Analog Clock Example}

Reimplemented from QWidget.

Definition at line 256 of file q3dockwindow.cpp.

References QStyle::drawPrimitive(), Qt::Horizontal, QStyleOption::init(), orientation(), p, QStyle::PE_IndicatorDockWidgetResizeHandle, QStyleOption::state, QStyle::State_Horizontal, and QWidget::style().

{
    QPainter p(this);
    QStyleOption opt(0);
    opt.init(this);
    if (orientation() == Qt::Horizontal)
        opt.state |= QStyle::State_Horizontal;
    style()->drawPrimitive(QStyle::PE_IndicatorDockWidgetResizeHandle, &opt, &p, this);
}

Here is the call graph for this function:

void Q3DockWindowResizeHandle::mouseMoveEvent

(

QMouseEvent *

e

)

[protected, virtual]

This event handler, for event event, can be reimplemented in a subclass to receive mouse move events for the widget.

If mouse tracking is switched off, mouse move events only occur if a mouse button is pressed while the mouse is being moved. If mouse tracking is switched on, mouse move events occur even if no mouse button is pressed.

QMouseEvent::pos() reports the position of the mouse cursor, relative to this widget. For press and release events, the position is usually the same as the position of the last mouse move event, but it might be different if the user's hand shakes. This is a feature of the underlying window system, not Qt.

See also:

setMouseTracking(), mousePressEvent(), mouseReleaseEvent(), mouseDoubleClickEvent(), event(), QMouseEvent, {Scribble Example}

Reimplemented from QWidget.

Definition at line 140 of file q3dockwindow.cpp.

References Q3DockWindow::area(), dockWindow, drawLine(), firstPos, QMouseEvent::globalPos(), QWidget::height(), Qt::Horizontal, lastPos, QWidget::mapToGlobal(), mousePressed, mouseReleaseEvent(), Q3DockWindow::opaqueMoving(), orientation(), Q3DockArea::orientation(), w, QWidget::width(), QWidget::window(), QPoint::x(), and QPoint::y().

{
    if (!mousePressed)
        return;
    if (!dockWindow->opaqueMoving()) {
        if (orientation() != dockWindow->area()->orientation()) {
            if (orientation() == Qt::Horizontal) {
                int minpos = dockWindow->area()->mapToGlobal(QPoint(0, 0)).y();
                int maxpos = dockWindow->area()->mapToGlobal(QPoint(0, 0)).y() + dockWindow->area()->height();
                if (e->globalPos().y() < minpos || e->globalPos().y() > maxpos)
                    return;
            } else {
                int minpos = dockWindow->area()->mapToGlobal(QPoint(0, 0)).x();
                int maxpos = dockWindow->area()->mapToGlobal(QPoint(0, 0)).x() + dockWindow->area()->width();
                if (e->globalPos().x() < minpos || e->globalPos().x() > maxpos)
                    return;
            }
        } else {
            QWidget *w = dockWindow->area()->window();
            if (w) {
                if (orientation() == Qt::Horizontal) {
                    int minpos = w->mapToGlobal(QPoint(0, 0)).y();
                    int maxpos = w->mapToGlobal(QPoint(0, 0)).y() + w->height();
                    if (e->globalPos().y() < minpos || e->globalPos().y() > maxpos)
                        return;
                } else {
                    int minpos = w->mapToGlobal(QPoint(0, 0)).x();
                    int maxpos = w->mapToGlobal(QPoint(0, 0)).x() + w->width();
                    if (e->globalPos().x() < minpos || e->globalPos().x() > maxpos)
                        return;
                }
            }
        }
    }

    if (!dockWindow->opaqueMoving())
        drawLine(lastPos);
    lastPos = e->globalPos();
    if (dockWindow->opaqueMoving()) {
        mouseReleaseEvent(e);
        mousePressed = true;
        firstPos = e->globalPos();
    }
    if (!dockWindow->opaqueMoving())
        drawLine(e->globalPos());
}

Here is the call graph for this function:

void Q3DockWindowResizeHandle::mousePressEvent

(

QMouseEvent *

e

)

[protected, virtual]

This event handler, for event event, can be reimplemented in a subclass to receive mouse press events for the widget.

If you create new widgets in the mousePressEvent() the mouseReleaseEvent() may not end up where you expect, depending on the underlying window system (or X11 window manager), the widgets' location and maybe more.

The default implementation implements the closing of popup widgets when you click outside the window. For other widget types it does nothing.

See also:

mouseReleaseEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent, {Scribble Example}

Reimplemented from QWidget.

Definition at line 126 of file q3dockwindow.cpp.

References QEvent::accept(), QMouseEvent::button(), dockWindow, drawLine(), firstPos, QMouseEvent::globalPos(), QEvent::ignore(), lastPos, Qt::LeftButton, mousePressed, Q3DockWindow::opaqueMoving(), and startLineDraw().

{
    e->ignore();
    if (e->button() != Qt::LeftButton)
        return;
    e->accept();
    mousePressed = true;
    if (!dockWindow->opaqueMoving())
        startLineDraw();
    lastPos = firstPos = e->globalPos();
    if (!dockWindow->opaqueMoving())
        drawLine(e->globalPos());
}

Here is the call graph for this function:

void Q3DockWindowResizeHandle::mouseReleaseEvent

(

QMouseEvent *

e

)

[protected, virtual]

This event handler, for event event, can be reimplemented in a subclass to receive mouse release events for the widget.

See also:

mousePressEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent, {Scribble Example}

Reimplemented from QWidget.

Definition at line 187 of file q3dockwindow.cpp.

References Q3DockWindow::area(), d, dockWindow, drawLine(), endLineDraw(), firstPos, QMouseEvent::globalPos(), Q3DockArea::handlePosition(), QWidget::height(), Qt::Horizontal, Q3DockArea::invalidNextOffset(), lastPos, Q3DockArea::maxSpace(), QWidget::minimumHeight(), QWidget::minimumWidth(), mousePressed, Q3DockArea::Normal, Q3DockWindow::opaqueMoving(), orientation(), Q3DockArea::orientation(), QCoreApplication::postEvent(), qMax(), qMin(), Q3DockArea::setFixedExtent(), Q3DockWindow::setFixedExtentHeight(), Q3DockWindow::setFixedExtentWidth(), QWidget::width(), QPoint::x(), and QPoint::y().

Referenced by mouseMoveEvent().

{
    if (mousePressed) {
        if (!dockWindow->opaqueMoving()) {
            drawLine(lastPos);
            endLineDraw();
        }
        if (orientation() != dockWindow->area()->orientation())
            dockWindow->area()->invalidNextOffset(dockWindow);
        if (orientation() == Qt::Horizontal) {
            int dy;
            if (dockWindow->area()->handlePosition() == Q3DockArea::Normal || orientation() != dockWindow->area()->orientation())
                dy = e->globalPos().y() - firstPos.y();
            else
                dy =  firstPos.y() - e->globalPos().y();
            int d = dockWindow->height() + dy;
            if (orientation() != dockWindow->area()->orientation()) {
                dockWindow->setFixedExtentHeight(-1);
                d = qMax(d, dockWindow->minimumHeight());
                int ms = dockWindow->area()->maxSpace(d, dockWindow);
                d = qMin(d, ms);
                dockWindow->setFixedExtentHeight(d);
            } else {
                dockWindow->area()->setFixedExtent(d, dockWindow);
            }
        } else {
            int dx;
            if (dockWindow->area()->handlePosition() == Q3DockArea::Normal || orientation() != dockWindow->area()->orientation())
                dx = e->globalPos().x() - firstPos.x();
            else
                dx = firstPos.x() - e->globalPos().x();
            int d = dockWindow->width() + dx;
            if (orientation() != dockWindow->area()->orientation()) {
                dockWindow->setFixedExtentWidth(-1);
                d = qMax(d, dockWindow->minimumWidth());
                int ms = dockWindow->area()->maxSpace(d, dockWindow);
                d = qMin(d, ms);
                dockWindow->setFixedExtentWidth(d);
            } else {
                dockWindow->area()->setFixedExtent(d, dockWindow);
            }
        }
    }

    QApplication::postEvent(dockWindow->area(), new QEvent(QEvent::LayoutHint));
    mousePressed = false;
}

Here is the call graph for this function:

bool Q3DockWindowResizeHandle::event

(

QEvent *

event

)

[protected, virtual]

This is the main event handler; it handles event event. You can reimplement this function in a subclass, but we recommend using one of the specialized event handlers instead.

Key press and release events are treated differently from other events. event() checks for Tab and Shift+Tab and tries to move the focus appropriately. If there is no widget to move the focus to (or the key press is not Tab or Shift+Tab), event() calls keyPressEvent().

Mouse and tablet event handling is also slightly special: only when the widget is enabled, event() will call the specialized handlers such as mousePressEvent(); otherwise it will discard the event.

This function returns true if the event was recognized, otherwise it returns false. If the recognized event was accepted (see QEvent::accepted), any further processing such as event propagation to the parent widget stops.

See also:

closeEvent(), focusInEvent(), focusOutEvent(), enterEvent(), keyPressEvent(), keyReleaseEvent(), leaveEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), moveEvent(), paintEvent(), resizeEvent(), QObject::event(), QObject::timerEvent()

Reimplemented from QWidget.

Definition at line 235 of file q3dockwindow.cpp.

References QWidget::event(), QEvent::HoverEnter, QEvent::HoverLeave, mouseOver, and QWidget::update().

{
    switch (event->type()) {
    case QEvent::HoverEnter:
        if (!mouseOver) {
            mouseOver = true;
            update();
        }
        break;
    case QEvent::HoverLeave:
        if (mouseOver) {
            mouseOver = false;
            update();
        }
        break;
    default:
        break;
    }
    return QWidget::event(event);
}

Here is the call graph for this function:

void Q3DockWindowResizeHandle::startLineDraw

(

)

[private]

Definition at line 266 of file q3dockwindow.cpp.

References endLineDraw(), QRubberBand::Line, rubberBand, QRubberBand::setGeometry(), and QWidget::show().

Referenced by mousePressEvent().

{
    if (rubberBand)
        endLineDraw();
    rubberBand = new QRubberBand(QRubberBand::Line);
    rubberBand->setGeometry(-1, -1, 1, 1);
    rubberBand->show();
}

Here is the call graph for this function:

void Q3DockWindowResizeHandle::endLineDraw

(

)

[private]

Definition at line 275 of file q3dockwindow.cpp.

References rubberBand.

Referenced by mouseReleaseEvent(), and startLineDraw().

{
    delete rubberBand;
    rubberBand = 0;
}

void Q3DockWindowResizeHandle::drawLine

(

const QPoint &

globalPos

)

[private]

Definition at line 281 of file q3dockwindow.cpp.

References Q3DockWindow::area(), dockWindow, QWidget::height(), Qt::Horizontal, QWidget::mapToGlobal(), orientation(), Q3DockWindow::orientation(), rubberBand, QRubberBand::setGeometry(), start, QWidget::width(), QPoint::x(), and QPoint::y().

Referenced by mouseMoveEvent(), mousePressEvent(), and mouseReleaseEvent().

{
    QPoint start = mapToGlobal(QPoint(0, 0));
    QPoint starta = dockWindow->area()->mapToGlobal(QPoint(0, 0));
    QPoint end = globalPos;
    if (orientation() == Qt::Horizontal) {
        if (orientation() == dockWindow->orientation())
            rubberBand->setGeometry(starta.x(), end.y(), dockWindow->area()->width(), height());
        else
            rubberBand->setGeometry(start.x(), end.y(), width(), height());
    } else {
        if (orientation() == dockWindow->orientation())
            rubberBand->setGeometry(end.x(), starta.y(), width(), dockWindow->area()->height());
        else
            rubberBand->setGeometry(end.x(), start.y(), width(), height());
    }
}

Here is the call graph for this function:

---

Member Data Documentation

Qt::Orientation Q3DockWindowResizeHandle::orient [private]

Definition at line 80 of file q3dockwindow.cpp.

Referenced by orientation(), and setOrientation().

bool Q3DockWindowResizeHandle::mousePressed [private]

Definition at line 81 of file q3dockwindow.cpp.

Referenced by mouseMoveEvent(), mousePressEvent(), and mouseReleaseEvent().

QRubberBand* Q3DockWindowResizeHandle::rubberBand [private]

Definition at line 82 of file q3dockwindow.cpp.

Referenced by drawLine(), endLineDraw(), and startLineDraw().

QPoint Q3DockWindowResizeHandle::lastPos [private]

Definition at line 83 of file q3dockwindow.cpp.

Referenced by mouseMoveEvent(), mousePressEvent(), and mouseReleaseEvent().

QPoint Q3DockWindowResizeHandle::firstPos [private]

Definition at line 83 of file q3dockwindow.cpp.

Referenced by mouseMoveEvent(), mousePressEvent(), and mouseReleaseEvent().

Q3DockWindow* Q3DockWindowResizeHandle::dockWindow [private]

Definition at line 84 of file q3dockwindow.cpp.

Referenced by drawLine(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), and sizeHint().

bool Q3DockWindowResizeHandle::mouseOver [private]

Definition at line 85 of file q3dockwindow.cpp.

Referenced by event().

---

The documentation for this class was generated from the following file:

• src/qt3support/widgets/q3dockwindow.cpp

---