summaryrefslogtreecommitdiffstats
path: root/src/gui/widgets/qfocusframe.cpp
diff options
context:
space:
mode:
authorLars Knoll <lars.knoll@nokia.com>2009-03-23 09:18:55 (GMT)
committerSimon Hausmann <simon.hausmann@nokia.com>2009-03-23 09:18:55 (GMT)
commite5fcad302d86d316390c6b0f62759a067313e8a9 (patch)
treec2afbf6f1066b6ce261f14341cf6d310e5595bc1 /src/gui/widgets/qfocusframe.cpp
downloadQt-e5fcad302d86d316390c6b0f62759a067313e8a9.zip
Qt-e5fcad302d86d316390c6b0f62759a067313e8a9.tar.gz
Qt-e5fcad302d86d316390c6b0f62759a067313e8a9.tar.bz2
Long live Qt 4.5!
Diffstat (limited to 'src/gui/widgets/qfocusframe.cpp')
-rw-r--r--src/gui/widgets/qfocusframe.cpp267
1 files changed, 267 insertions, 0 deletions
diff --git a/src/gui/widgets/qfocusframe.cpp b/src/gui/widgets/qfocusframe.cpp
new file mode 100644
index 0000000..4e5b630
--- /dev/null
+++ b/src/gui/widgets/qfocusframe.cpp
@@ -0,0 +1,267 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** Contact: Qt Software Information (qt-info@nokia.com)
+**
+** This file is part of the QtGui module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the either Technology Preview License Agreement or the
+** Beta Release License Agreement.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file. Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain
+** additional rights. These rights are described in the Nokia Qt LGPL
+** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this
+** package.
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file. Please review the following information to
+** ensure the GNU General Public License version 3.0 requirements will be
+** met: http://www.gnu.org/copyleft/gpl.html.
+**
+** If you are unsure which license is appropriate for your use, please
+** contact the sales department at qt-sales@nokia.com.
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include "qfocusframe.h"
+#include "qstyle.h"
+#include "qbitmap.h"
+#include "qstylepainter.h"
+#include "qstyleoption.h"
+#include "qdebug.h"
+#include <private/qwidget_p.h>
+
+QT_BEGIN_NAMESPACE
+
+class QFocusFramePrivate : public QWidgetPrivate
+{
+ Q_DECLARE_PUBLIC(QFocusFrame)
+ QWidget *widget;
+
+public:
+ QFocusFramePrivate() {
+ widget = 0;
+ sendChildEvents = false;
+ }
+ void updateSize();
+ void update();
+};
+
+void QFocusFramePrivate::update()
+{
+ Q_Q(QFocusFrame);
+ q->setParent(widget->parentWidget());
+ updateSize();
+ if (q->parentWidget()->rect().intersects(q->geometry())) {
+ if (q->style()->styleHint(QStyle::SH_FocusFrame_AboveWidget, 0, q))
+ q->raise();
+ else
+ q->stackUnder(widget);
+ q->show();
+ } else {
+ q->hide();
+ }
+}
+
+void QFocusFramePrivate::updateSize()
+{
+ Q_Q(QFocusFrame);
+ int vmargin = q->style()->pixelMetric(QStyle::PM_FocusFrameVMargin),
+ hmargin = q->style()->pixelMetric(QStyle::PM_FocusFrameHMargin);
+ QRect geom(widget->x()-hmargin, widget->y()-vmargin,
+ widget->width()+(hmargin*2), widget->height()+(vmargin*2));
+ if(q->geometry() == geom)
+ return;
+
+ q->setGeometry(geom);
+ QStyleHintReturnMask mask;
+ QStyleOption opt;
+ q->initStyleOption(&opt);
+ if (q->style()->styleHint(QStyle::SH_FocusFrame_Mask, &opt, q, &mask))
+ q->setMask(mask.region);
+}
+
+/*!
+ Initialize \a option with the values from this QFocusFrame. This method is useful
+ for subclasses when they need a QStyleOption, but don't want to fill
+ in all the information themselves.
+
+ \sa QStyleOption::initFrom()
+*/
+void QFocusFrame::initStyleOption(QStyleOption *option) const
+{
+ if (!option)
+ return;
+
+ option->initFrom(this);
+}
+
+/*!
+ \class QFocusFrame
+ \brief The QFocusFrame widget provides a focus frame which can be
+ outside of a widget's normal paintable area.
+
+ \ingroup basicwidgets
+ \mainclass
+
+ Normally an application will not need to create its own
+ QFocusFrame as QStyle will handle this detail for
+ you. A style writer can optionally use a QFocusFrame to have a
+ focus area outside of the widget's paintable geometry. In this way
+ space need not be reserved for the widget to have focus but only
+ set on a QWidget with QFocusFrame::setWidget. It is, however,
+ legal to create your own QFocusFrame on a custom widget and set
+ its geometry manually via QWidget::setGeometry however you will
+ not get auto-placement when the focused widget changes size or
+ placement.
+*/
+
+/*!
+ Constructs a QFocusFrame.
+
+ The focus frame will not monitor \a parent for updates but rather
+ can be placed manually or by using QFocusFrame::setWidget. A
+ QFocusFrame sets Qt::WA_NoChildEventsForParent attribute; as a
+ result the parent will not receive a QEvent::ChildInserted event,
+ this will make it possible to manually set the geometry of the
+ QFocusFrame inside of a QSplitter or other child event monitoring
+ widget.
+
+ \sa QFocusFrame::setWidget()
+*/
+
+QFocusFrame::QFocusFrame(QWidget *parent)
+ : QWidget(*new QFocusFramePrivate, parent, 0)
+{
+ setAttribute(Qt::WA_TransparentForMouseEvents);
+ setFocusPolicy(Qt::NoFocus);
+ setAttribute(Qt::WA_NoChildEventsForParent, true);
+ setAttribute(Qt::WA_AcceptDrops, style()->styleHint(QStyle::SH_FocusFrame_AboveWidget, 0, this));
+}
+
+/*!
+ Destructor.
+*/
+
+QFocusFrame::~QFocusFrame()
+{
+}
+
+/*!
+ QFocusFrame will track changes to \a widget and resize itself automatically.
+ If the monitored widget's parent changes, QFocusFrame will follow the widget
+ and place itself around the widget automatically. If the monitored widget is deleted,
+ QFocusFrame will set it to zero.
+
+ \sa QFocusFrame::widget()
+*/
+
+void
+QFocusFrame::setWidget(QWidget *widget)
+{
+ Q_D(QFocusFrame);
+ if(widget == d->widget)
+ return;
+
+ if(d->widget)
+ d->widget->removeEventFilter(this);
+ if(widget && !widget->isWindow() && widget->parentWidget()->windowType() != Qt::SubWindow) {
+ d->widget = widget;
+ widget->installEventFilter(this);
+ d->update();
+ } else {
+ d->widget = 0;
+ hide();
+ }
+}
+
+/*!
+ Returns the currently monitored widget for automatically resize and
+ update.
+
+ \sa QFocusFrame::setWidget()
+*/
+
+QWidget *
+QFocusFrame::widget() const
+{
+ Q_D(const QFocusFrame);
+ return d->widget;
+}
+
+
+/*! \reimp */
+void
+QFocusFrame::paintEvent(QPaintEvent *)
+{
+ QStylePainter p(this);
+ QStyleOption option;
+ initStyleOption(&option);
+ p.drawControl(QStyle::CE_FocusFrame, option);
+}
+
+
+/*! \reimp */
+bool
+QFocusFrame::eventFilter(QObject *o, QEvent *e)
+{
+ Q_D(QFocusFrame);
+ if(o == d->widget) {
+ switch(e->type()) {
+ case QEvent::Move:
+ case QEvent::Resize:
+ d->updateSize();
+ break;
+ case QEvent::Hide:
+ case QEvent::StyleChange:
+ hide();
+ break;
+ case QEvent::ParentChange:
+ d->update();
+ break;
+ case QEvent::Show:
+ d->update();
+ show();
+ break;
+ case QEvent::PaletteChange:
+ setPalette(d->widget->palette());
+ break;
+ case QEvent::ZOrderChange:
+ if (style()->styleHint(QStyle::SH_FocusFrame_AboveWidget, 0, this))
+ raise();
+ else
+ stackUnder(d->widget);
+ break;
+ case QEvent::Destroy:
+ setWidget(0);
+ break;
+ default:
+ break;
+ }
+ }
+ return false;
+}
+
+/*! \reimp */
+bool QFocusFrame::event(QEvent *e)
+{
+ return QWidget::event(e);
+}
+
+QT_END_NAMESPACE