--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/src/gui/widgets/qrubberband.cpp Mon Jan 11 14:00:40 2010 +0000
@@ -0,0 +1,336 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (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 Technology Preview License Agreement accompanying
+** this package.
+**
+** 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.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include "qbitmap.h"
+#include "qevent.h"
+#include "qstylepainter.h"
+#include "qrubberband.h"
+#include "qtimer.h"
+
+#ifndef QT_NO_RUBBERBAND
+
+#include "qstyle.h"
+#include "qstyleoption.h"
+#ifdef Q_WS_MAC
+# include <private/qt_mac_p.h>
+# include <private/qt_cocoa_helpers_mac_p.h>
+#endif
+
+#include <qdebug.h>
+
+#include <private/qwidget_p.h>
+
+QT_BEGIN_NAMESPACE
+
+//### a rubberband window type would be a more elegant solution
+#define RUBBERBAND_WINDOW_TYPE Qt::ToolTip
+
+class QRubberBandPrivate : public QWidgetPrivate
+{
+ Q_DECLARE_PUBLIC(QRubberBand)
+public:
+ QRect rect;
+ QRubberBand::Shape shape;
+ QRegion clipping;
+ void updateMask();
+};
+
+/*!
+ Initialize \a option with the values from this QRubberBand. This method
+ is useful for subclasses when they need a QStyleOptionRubberBand, but don't want
+ to fill in all the information themselves.
+
+ \sa QStyleOption::initFrom()
+*/
+void QRubberBand::initStyleOption(QStyleOptionRubberBand *option) const
+{
+ if (!option)
+ return;
+ option->initFrom(this);
+ option->shape = d_func()->shape;
+#ifndef Q_WS_MAC
+ option->opaque = true;
+#else
+ option->opaque = windowFlags() & RUBBERBAND_WINDOW_TYPE;
+#endif
+}
+
+/*!
+ \class QRubberBand
+ \brief The QRubberBand class provides a rectangle or line that can
+ indicate a selection or a boundary.
+
+ A rubber band is often used to show a new bounding area (as in a
+ QSplitter or a QDockWidget that is undocking). Historically this has
+ been implemented using a QPainter and XOR, but this approach
+ doesn't always work properly since rendering can happen in the
+ window below the rubber band, but before the rubber band has been
+ "erased".
+
+ You can create a QRubberBand whenever you need to render a rubber band
+ around a given area (or to represent a single line), then call
+ setGeometry(), move() or resize() to position and size it. A common
+ pattern is to do this in conjunction with mouse events. For example:
+
+ \snippet doc/src/snippets/code/src_gui_widgets_qrubberband.cpp 0
+
+ If you pass a parent to QRubberBand's constructor, the rubber band will
+ display only inside its parent, but stays on top of other child widgets.
+ If no parent is passed, QRubberBand will act as a top-level widget.
+
+ Call show() to make the rubber band visible; also when the
+ rubber band is not a top-level. Hiding or destroying
+ the widget will make the rubber band disappear. The rubber band
+ can be a \l Rectangle or a \l Line (vertical or horizontal),
+ depending on the shape() it was given when constructed.
+*/
+
+// ### DOC: How about some nice convenience constructors?
+//QRubberBand::QRubberBand(QRubberBand::Type t, const QRect &rect, QWidget *p)
+//QRubberBand::QRubberBand(QRubberBand::Type t, int x, int y, int w, int h, QWidget *p)
+
+/*!
+ Constructs a rubber band of shape \a s, with parent \a p.
+
+ By default a rectangular rubber band (\a s is \c Rectangle) will
+ use a mask, so that a small border of the rectangle is all
+ that is visible. Some styles (e.g., native Mac OS X) will
+ change this and call QWidget::setWindowOpacity() to make a
+ semi-transparent filled selection rectangle.
+*/
+QRubberBand::QRubberBand(Shape s, QWidget *p)
+ : QWidget(*new QRubberBandPrivate, p, (p && p->windowType() != Qt::Desktop) ? Qt::Widget : RUBBERBAND_WINDOW_TYPE)
+{
+ Q_D(QRubberBand);
+ d->shape = s;
+ setAttribute(Qt::WA_TransparentForMouseEvents);
+#ifndef Q_WS_WIN
+ setAttribute(Qt::WA_NoSystemBackground);
+#endif //Q_WS_WIN
+ setAttribute(Qt::WA_WState_ExplicitShowHide);
+ setVisible(false);
+#ifdef Q_WS_MAC
+ if (isWindow()) {
+ createWinId();
+ extern OSWindowRef qt_mac_window_for(const QWidget *); //qwidget_mac.cpp
+ macWindowSetHasShadow(qt_mac_window_for(this), false);
+ }
+#endif
+}
+
+/*!
+ Destructor.
+*/
+QRubberBand::~QRubberBand()
+{
+}
+
+/*!
+ \enum QRubberBand::Shape
+
+ This enum specifies what shape a QRubberBand should have. This is
+ a drawing hint that is passed down to the style system, and can be
+ interpreted by each QStyle.
+
+ \value Line A QRubberBand can represent a vertical or horizontal
+ line. Geometry is still given in rect() and the line
+ will fill the given geometry on most styles.
+
+ \value Rectangle A QRubberBand can represent a rectangle. Some
+ styles will interpret this as a filled (often
+ semi-transparent) rectangle, or a rectangular
+ outline.
+*/
+
+/*!
+ Returns the shape of this rubber band. The shape can only be set
+ upon construction.
+*/
+QRubberBand::Shape QRubberBand::shape() const
+{
+ Q_D(const QRubberBand);
+ return d->shape;
+}
+
+/*!
+ \internal
+*/
+void QRubberBandPrivate::updateMask()
+{
+ Q_Q(QRubberBand);
+ QStyleHintReturnMask mask;
+ QStyleOptionRubberBand opt;
+ q->initStyleOption(&opt);
+ if (q->style()->styleHint(QStyle::SH_RubberBand_Mask, &opt, q, &mask)) {
+ q->setMask(mask.region);
+ } else {
+ q->clearMask();
+ }
+}
+
+/*!
+ \reimp
+*/
+void QRubberBand::paintEvent(QPaintEvent *)
+{
+ QStylePainter painter(this);
+ QStyleOptionRubberBand option;
+ initStyleOption(&option);
+ painter.drawControl(QStyle::CE_RubberBand, option);
+}
+
+/*!
+ \reimp
+*/
+void QRubberBand::changeEvent(QEvent *e)
+{
+ QWidget::changeEvent(e);
+ switch (e->type()) {
+ case QEvent::ParentChange:
+ if (parent()) {
+ setWindowFlags(windowFlags() & ~RUBBERBAND_WINDOW_TYPE);
+ } else {
+ setWindowFlags(windowFlags() | RUBBERBAND_WINDOW_TYPE);
+ }
+ break;
+ default:
+ break;
+ }
+
+ if (e->type() == QEvent::ZOrderChange)
+ raise();
+}
+
+/*!
+ \reimp
+*/
+void QRubberBand::showEvent(QShowEvent *e)
+{
+ raise();
+ e->ignore();
+}
+
+/*!
+ \reimp
+*/
+void QRubberBand::resizeEvent(QResizeEvent *)
+{
+ Q_D(QRubberBand);
+ d->updateMask();
+}
+
+/*!
+ \reimp
+*/
+void QRubberBand::moveEvent(QMoveEvent *)
+{
+ Q_D(QRubberBand);
+ d->updateMask();
+}
+
+/*!
+ \fn void QRubberBand::move(const QPoint &p);
+
+ \overload
+
+ Moves the rubberband to point \a p.
+
+ \sa resize()
+*/
+
+/*!
+ \fn void QRubberBand::move(int x, int y);
+
+ Moves the rubberband to point (\a x, \a y).
+
+ \sa resize()
+*/
+
+/*!
+ \fn void QRubberBand::resize(const QSize &size);
+
+ \overload
+
+ Resizes the rubberband so that its new size is \a size.
+
+ \sa move()
+*/
+
+/*!
+ \fn void QRubberBand::resize(int width, int height);
+
+ Resizes the rubberband so that its width is \a width, and its
+ height is \a height.
+
+ \sa move()
+*/
+
+/*!
+ \fn void QRubberBand::setGeometry(const QRect &rect)
+
+ Sets the geometry of the rubber band to \a rect, specified in the coordinate system
+ of its parent widget.
+
+ \sa QWidget::geometry
+*/
+void QRubberBand::setGeometry(const QRect &geom)
+{
+ QWidget::setGeometry(geom);
+}
+
+/*!
+ \fn void QRubberBand::setGeometry(int x, int y, int width, int height)
+ \overload
+
+ Sets the geometry of the rubberband to the rectangle whose top-left corner lies at
+ the point (\a x, \a y), and with dimensions specified by \a width and \a height.
+ The geometry is specified in the parent widget's coordinate system.
+*/
+
+/*! \reimp */
+bool QRubberBand::event(QEvent *e)
+{
+ return QWidget::event(e);
+}
+
+QT_END_NAMESPACE
+
+#endif // QT_NO_RUBBERBAND