Q3DockWindowHandle Class Reference

Inheritance diagram for Q3DockWindowHandle:

[legend]Collaboration diagram for Q3DockWindowHandle:

[legend]List of all members.

---

Detailed Description

Definition at line 306 of file q3dockwindow.cpp.

Signals
void	doubleClicked ()
Public Member Functions
	Q3DockWindowHandle (Q3DockWindow *dw)
void	updateGui ()
QSize	minimumSizeHint () const
QSize	minimumSize () const
QSize	sizeHint () const
void	setOpaqueMoving (bool b)
QString	windowTitle () const
Protected Member Functions
void	paintEvent (QPaintEvent *e)
void	resizeEvent (QResizeEvent *e)
void	mousePressEvent (QMouseEvent *e)
void	mouseMoveEvent (QMouseEvent *e)
void	mouseReleaseEvent (QMouseEvent *e)
void	mouseDoubleClickEvent (QMouseEvent *e)
void	keyPressEvent (QKeyEvent *e)
void	keyReleaseEvent (QKeyEvent *e)
void	changeEvent (QEvent *)
Private Slots
void	minimize ()
Private Attributes
Q3DockWindow *	dockWindow
QPoint	offset
QToolButton *	closeButton
QTimer *	timer
uint	opaque: 1
uint	mousePressed: 1
uint	hadDblClick: 1
uint	ctrlDown: 1
QPointer< QWidget >	oldFocus
Friends
class	Q3DockWindow
class	Q3DockWindowTitleBar

---

Constructor & Destructor Documentation

Q3DockWindowHandle::Q3DockWindowHandle

(

Q3DockWindow *

dw

)

Definition at line 384 of file q3dockwindow.cpp.

References QObject::connect(), ctrlDown, minimize(), QWidget::setCursor(), SIGNAL, Qt::SizeAllCursor, SLOT, and timer.

    : QWidget(dw, "qt_dockwidget_internal"), dockWindow(dw),
      closeButton(0), opaque(default_opaque), mousePressed(false)
{
    ctrlDown = false;
    timer = new QTimer(this);
    connect(timer, SIGNAL(timeout()), this, SLOT(minimize()));
#ifdef Q_WS_WIN
    setCursor(Qt::SizeAllCursor);
#endif
}

Here is the call graph for this function:

---

Member Function Documentation

void Q3DockWindowHandle::updateGui

(

)

Definition at line 503 of file q3dockwindow.cpp.

References Q3DockWindow::area(), Qt::ArrowCursor, closeButton, QObject::connect(), dockWindow, QWidget::height(), QWidget::hide(), Qt::Horizontal, QStyleOption::init(), Q3DockWindow::isCloseEnabled(), QWidget::move(), Q3DockArea::orientation(), QWidget::setCursor(), QWidget::setFixedSize(), QAbstractButton::setIcon(), QWidget::show(), SIGNAL, SLOT, QStyle::SP_DockWidgetCloseButton, QWidget::style(), QWidget::width(), and QWidget::x().

Referenced by resizeEvent(), Q3DockWindow::setCloseMode(), and Q3DockWindow::updateGui().

{
    if (!closeButton) {
        closeButton = new QToolButton(this, "qt_close_button1");
#ifndef QT_NO_CURSOR
        closeButton->setCursor(Qt::ArrowCursor);
#endif
        QStyleOption opt(0);
        opt.init(closeButton);
        closeButton->setIcon(style()->standardPixmap(QStyle::SP_DockWidgetCloseButton, &opt,
                                                    closeButton));
        closeButton->setFixedSize(12, 12);
        connect(closeButton, SIGNAL(clicked()),
                 dockWindow, SLOT(hide()));
    }

    if (dockWindow->isCloseEnabled() && dockWindow->area())
        closeButton->show();
    else
        closeButton->hide();

    if (!dockWindow->area())
        return;

    if (dockWindow->area()->orientation() == Qt::Horizontal) {
        int off = (width() - closeButton->width() - 1) / 2;
        closeButton->move(off, 2);
    } else {
        int off = (height() - closeButton->height() - 1) / 2;
        int x = QApplication::reverseLayout() ? 2 : width() - closeButton->width() - 2;
        closeButton->move(x, off);
    }
}

Here is the call graph for this function:

QSize Q3DockWindowHandle::minimumSizeHint

(

)

const [virtual]

Reimplemented from QWidget.

Definition at line 550 of file q3dockwindow.cpp.

References Q3DockWindow::dockArea, dockWindow, Qt::Horizontal, Q3DockWindow::isCloseEnabled(), Q3DockWindow::orientation(), QStyle::pixelMetric(), QStyle::PM_ToolBarHandleExtent, and QWidget::style().

Referenced by minimumSize().

{
    if (!dockWindow->dockArea)
        return QSize(0, 0);
    int wh = dockWindow->isCloseEnabled() ? 17 : style()->pixelMetric(QStyle::PM_ToolBarHandleExtent, 0, this);
    if (dockWindow->orientation() == Qt::Horizontal)
        return QSize(wh, 0);
    return QSize(0, wh);
}

Here is the call graph for this function:

QSize Q3DockWindowHandle::minimumSize

(

)

const [inline]

Reimplemented from QWidget.

Definition at line 318 of file q3dockwindow.cpp.

References minimumSizeHint().

Referenced by sizeHint().

{ return minimumSizeHint(); }

Here is the call graph for this function:

QSize Q3DockWindowHandle::sizeHint

(

)

const [inline, virtual]

Reimplemented from QWidget.

Definition at line 319 of file q3dockwindow.cpp.

References minimumSize().

{ return minimumSize(); }

Here is the call graph for this function:

void Q3DockWindowHandle::setOpaqueMoving

(

bool

b

)

[inline]

Definition at line 320 of file q3dockwindow.cpp.

References opaque.

Referenced by Q3DockWindow::setOpaqueMoving().

{ opaque = b; }

QString Q3DockWindowHandle::windowTitle

(

)

const [inline]

Reimplemented from QWidget.

Definition at line 322 of file q3dockwindow.cpp.

References dockWindow, and Q3DockWindow::windowTitle().

{ return dockWindow->windowTitle(); }

Here is the call graph for this function:

void Q3DockWindowHandle::doubleClicked

(

)

[signal]

Referenced by mouseDoubleClickEvent().

void Q3DockWindowHandle::paintEvent

(

QPaintEvent *

e

)

[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 396 of file q3dockwindow.cpp.

References Q3DockWindow::area(), QStyleOptionQ3DockWindow::closeEnabled, QStyleOption::direction, Q3DockWindow::dockArea, QStyleOptionQ3DockWindow::docked, dockWindow, QStyle::drawPrimitive(), Qt::Horizontal, QStyleOption::init(), Q3DockWindow::isCloseEnabled(), opaque, Q3DockArea::orientation(), p, QWidget::paintEvent(), QStyle::PE_IndicatorToolBarHandle, QStyleOption::rect, QWidget::rect(), QStyle::SE_Q3DockWindowHandleRect, QStyleOption::state, QStyle::State_Horizontal, QWidget::style(), and QStyle::visualRect().

{
    if (!dockWindow->dockArea && !opaque)
        return;
    QPainter p(this);
    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();
    opt.rect = QStyle::visualRect(opt.direction, opt.rect,
                                  style()->subElementRect(QStyle::SE_Q3DockWindowHandleRect, &opt, this));
    style()->drawPrimitive(QStyle::PE_IndicatorToolBarHandle, &opt, &p, this);
    QWidget::paintEvent(e);
}

Here is the call graph for this function:

void Q3DockWindowHandle::resizeEvent

(

QResizeEvent *

e

)

[protected, virtual]

This event handler can be reimplemented in a subclass to receive widget resize events which are passed in the event parameter. When resizeEvent() is called, the widget already has its new geometry. The old size is accessible through QResizeEvent::oldSize().

The widget will be erased and receive a paint event immediately after processing the resize event. No drawing need be (or should be) done inside this handler.

See also:

moveEvent(), event(), resize(), QResizeEvent, paintEvent(), {Scribble Example}

Reimplemented from QWidget.

Definition at line 498 of file q3dockwindow.cpp.

References updateGui().

{
    updateGui();
}

Here is the call graph for this function:

void Q3DockWindowHandle::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 435 of file q3dockwindow.cpp.

References QEvent::accept(), QMouseEvent::button(), ctrlDown, Q3DockWindow::dockArea, dockWindow, hadDblClick, QEvent::ignore(), Qt::LeftButton, QWidget::mapToGlobal(), mousePressed, offset, oldFocus, opaque, QMouseEvent::pos(), qApp, QWidget::setFocus(), and Q3DockWindow::startRectDraw().

{
    if (!dockWindow->dockArea)
        return;
    ctrlDown = (e->state() & Qt::ControlButton) == Qt::ControlButton;
    oldFocus = qApp->focusWidget();
    setFocus();
    e->ignore();
    if (e->button() != Qt::LeftButton)
        return;
    e->accept();
    hadDblClick = false;
    mousePressed = true;
    offset = e->pos();
    dockWindow->startRectDraw(mapToGlobal(e->pos()), !opaque);
    if (!opaque)
        qApp->installEventFilter(dockWindow);
}

Here is the call graph for this function:

void Q3DockWindowHandle::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 454 of file q3dockwindow.cpp.

References ctrlDown, dockWindow, QMouseEvent::globalPos(), Q3DockWindow::handleMove(), mousePressed, offset, opaque, QMouseEvent::pos(), and Q3DockWindow::updatePosition().

{
    if (!mousePressed || e->pos() == offset)
        return;
    ctrlDown = (e->state() & Qt::ControlButton) == Qt::ControlButton;
    dockWindow->handleMove(e->pos() - offset, e->globalPos(), !opaque);
    if (opaque)
        dockWindow->updatePosition(e->globalPos());
}

Here is the call graph for this function:

void Q3DockWindowHandle::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 464 of file q3dockwindow.cpp.

References ctrlDown, dockWindow, QApplication::doubleClickInterval(), Q3DockWindow::endRectDraw(), QMouseEvent::globalPos(), hadDblClick, Q3DockWindowTitleBar::mousePressed, mousePressed, offset, oldFocus, opaque, QWidget::parentWidget(), QMouseEvent::pos(), QCoreApplication::postEvent(), qApp, QWidget::releaseMouse(), QTimer::start(), timer, Q3DockWindow::titleBar, and Q3DockWindow::updatePosition().

{
    ctrlDown = false;
    qApp->removeEventFilter(dockWindow);
    if (oldFocus)
        oldFocus->setFocus();
    if (!mousePressed)
        return;
    dockWindow->endRectDraw(!opaque);
    mousePressed = false;
#ifdef Q_WS_MAC
    releaseMouse();
#endif
    if (!hadDblClick && offset == e->pos()) {
        timer->start(QApplication::doubleClickInterval(), true);
    } else if (!hadDblClick) {
        dockWindow->updatePosition(e->globalPos());
    }
    if (opaque)
        dockWindow->titleBar->mousePressed = false;
    if (dockWindow->parentWidget())
        QApplication::postEvent(dockWindow->parentWidget(), new QEvent(QEvent::LayoutHint));
}

Here is the call graph for this function:

void Q3DockWindowHandle::mouseDoubleClickEvent

(

QMouseEvent *

e

)

[protected, virtual]

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

The default implementation generates a normal mouse press event.

Note that the widgets gets a mousePressEvent() and a mouseReleaseEvent() before the mouseDoubleClickEvent().

See also:

mousePressEvent(), mouseReleaseEvent() mouseMoveEvent(), event(), QMouseEvent

Reimplemented from QWidget.

Definition at line 560 of file q3dockwindow.cpp.

References QEvent::accept(), QMouseEvent::button(), dockWindow, doubleClicked(), emit, hadDblClick, QEvent::ignore(), Qt::LeftButton, QWidget::parentWidget(), QCoreApplication::postEvent(), QTimer::stop(), and timer.

{
    e->ignore();
    if (e->button() != Qt::LeftButton)
        return;
    e->accept();
    timer->stop();
    emit doubleClicked();
    hadDblClick = true;
    if (dockWindow->parentWidget())
        QApplication::postEvent(dockWindow->parentWidget(), new QEvent(QEvent::LayoutHint));
}

Here is the call graph for this function:

void Q3DockWindowHandle::keyPressEvent

(

QKeyEvent *

e

)

[protected, virtual]

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

A widget must call setFocusPolicy() to accept focus initially and have focus in order to receive a key press event.

If you reimplement this handler, it is very important that you ignore() the event if you do not understand it, so that the widget's parent can interpret it.

The default implementation closes popup widgets if the user presses Esc. Otherwise the event is ignored.

See also:

keyReleaseEvent(), QKeyEvent::ignore(), setFocusPolicy(), focusInEvent(), focusOutEvent(), event(), QKeyEvent, {Tetrix Example}

Reimplemented from QWidget.

Definition at line 415 of file q3dockwindow.cpp.

References ctrlDown, dockWindow, Q3DockWindow::handleMove(), QKeyEvent::key(), Qt::Key_Control, QWidget::mapFromGlobal(), mousePressed, offset, opaque, and QCursor::pos().

{
    if (!mousePressed)
        return;
    if (e->key() == Qt::Key_Control) {
        ctrlDown = true;
        dockWindow->handleMove(mapFromGlobal(QCursor::pos()) - offset, QCursor::pos(), !opaque);
    }
}

Here is the call graph for this function:

void Q3DockWindowHandle::keyReleaseEvent

(

QKeyEvent *

e

)

[protected, virtual]

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

A widget must accept focus initially and have focus in order to receive a key release event.

If you reimplement this handler, it is very important that you ignore() the release if you do not understand it, so that the widget's parent can interpret it.

The default implementation ignores the event.

See also:

keyPressEvent(), QKeyEvent::ignore(), setFocusPolicy(), focusInEvent(), focusOutEvent(), event(), QKeyEvent

Reimplemented from QWidget.

Definition at line 425 of file q3dockwindow.cpp.

References ctrlDown, dockWindow, Q3DockWindow::handleMove(), QKeyEvent::key(), Qt::Key_Control, QWidget::mapFromGlobal(), mousePressed, offset, opaque, and QCursor::pos().

{
    if (!mousePressed)
        return;
    if (e->key() == Qt::Key_Control) {
        ctrlDown = false;
        dockWindow->handleMove(mapFromGlobal(QCursor::pos()) - offset, QCursor::pos(), !opaque);
    }
}

Here is the call graph for this function:

void Q3DockWindowHandle::changeEvent

(

QEvent *

ev

)

[protected, virtual]

This event handler can be reimplemented to handle state changes.

The state being changed in this event can be retrieved through event event.

Change events include: QEvent::ToolBarChange, QEvent::ActivationChange, QEvent::EnabledChange, QEvent::FontChange, QEvent::StyleChange, QEvent::PaletteChange, QEvent::WindowTitleChange, QEvent::IconTextChange, QEcvent::ModifiedChange, QEvent::MouseTrackingChange, QEvent::ParentChange, QEvent::WindowStateChange, QEvent::LanguageChange, QEvent::LocaleChange, QEvent::LayoutDirectionChange.

Reimplemented from QWidget.

Definition at line 537 of file q3dockwindow.cpp.

References QWidget::changeEvent(), closeButton, QStyleOption::init(), QStyle::SP_DockWidgetCloseButton, QWidget::style(), QEvent::StyleChange, and QEvent::type().

{
    if(ev->type() == QEvent::StyleChange) {
        if (closeButton) {
            QStyleOption opt(0);
            opt.init(closeButton);
            closeButton->setIcon(style()->standardPixmap(QStyle::SP_DockWidgetCloseButton,
                                                        &opt, closeButton));
        }
    }
    QWidget::changeEvent(ev);
}

Here is the call graph for this function:

void Q3DockWindowHandle::minimize

(

)

[private, slot]

Definition at line 488 of file q3dockwindow.cpp.

References Q3DockWindow::area(), dockWindow, Q3MainWindow::isDockEnabled(), Q3MainWindow::moveDockWindow(), and QWidget::parentWidget().

Referenced by Q3DockWindowHandle().

{
    if (!dockWindow->area())
        return;

    Q3MainWindow *mw = qobject_cast<Q3MainWindow*>(dockWindow->area()->parentWidget());
    if (mw && mw->isDockEnabled(dockWindow, Qt::DockMinimized))
        mw->moveDockWindow(dockWindow, Qt::DockMinimized);
}

---

Friends And Related Function Documentation

friend class Q3DockWindow [friend]

Definition at line 310 of file q3dockwindow.cpp.

friend class Q3DockWindowTitleBar [friend]

Definition at line 311 of file q3dockwindow.cpp.

---

Member Data Documentation

Q3DockWindow* Q3DockWindowHandle::dockWindow [private]

Definition at line 342 of file q3dockwindow.cpp.

Referenced by keyPressEvent(), keyReleaseEvent(), minimize(), minimumSizeHint(), mouseDoubleClickEvent(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), paintEvent(), updateGui(), and windowTitle().

QPoint Q3DockWindowHandle::offset [private]

Definition at line 343 of file q3dockwindow.cpp.

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

QToolButton* Q3DockWindowHandle::closeButton [private]

Definition at line 344 of file q3dockwindow.cpp.

Referenced by changeEvent(), and updateGui().

QTimer* Q3DockWindowHandle::timer [private]

Definition at line 345 of file q3dockwindow.cpp.

Referenced by mouseDoubleClickEvent(), mouseReleaseEvent(), and Q3DockWindowHandle().

uint Q3DockWindowHandle::opaque [private]

Definition at line 346 of file q3dockwindow.cpp.

Referenced by keyPressEvent(), keyReleaseEvent(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), paintEvent(), and setOpaqueMoving().

uint Q3DockWindowHandle::mousePressed [private]

Definition at line 347 of file q3dockwindow.cpp.

Referenced by Q3DockWindow::eventFilter(), keyPressEvent(), keyReleaseEvent(), mouseMoveEvent(), mousePressEvent(), Q3DockWindowTitleBar::mouseReleaseEvent(), mouseReleaseEvent(), and Q3DockWindow::updateGui().

uint Q3DockWindowHandle::hadDblClick [private]

Definition at line 348 of file q3dockwindow.cpp.

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

uint Q3DockWindowHandle::ctrlDown [private]

Definition at line 349 of file q3dockwindow.cpp.

Referenced by Q3DockWindow::handleMove(), keyPressEvent(), keyReleaseEvent(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), and Q3DockWindowHandle().

QPointer<QWidget> Q3DockWindowHandle::oldFocus [private]

Definition at line 350 of file q3dockwindow.cpp.

Referenced by mousePressEvent(), and mouseReleaseEvent().

---

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

• src/qt3support/widgets/q3dockwindow.cpp

---