Qt 4.8
qrubberband.h
Go to the documentation of this file.
1 /****************************************************************************
2 **
3 ** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
4 ** Contact: http://www.qt-project.org/legal
5 **
6 ** This file is part of the QtGui module of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL$
9 ** Commercial License Usage
10 ** Licensees holding valid commercial Qt licenses may use this file in
11 ** accordance with the commercial license agreement provided with the
12 ** Software or, alternatively, in accordance with the terms contained in
13 ** a written agreement between you and Digia. For licensing terms and
14 ** conditions see http://qt.digia.com/licensing. For further information
15 ** use the contact form at http://qt.digia.com/contact-us.
16 **
17 ** GNU Lesser General Public License Usage
18 ** Alternatively, this file may be used under the terms of the GNU Lesser
19 ** General Public License version 2.1 as published by the Free Software
20 ** Foundation and appearing in the file LICENSE.LGPL included in the
21 ** packaging of this file. Please review the following information to
22 ** ensure the GNU Lesser General Public License version 2.1 requirements
23 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
24 **
25 ** In addition, as a special exception, Digia gives you certain additional
26 ** rights. These rights are described in the Digia Qt LGPL Exception
27 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
28 **
29 ** GNU General Public License Usage
30 ** Alternatively, this file may be used under the terms of the GNU
31 ** General Public License version 3.0 as published by the Free Software
32 ** Foundation and appearing in the file LICENSE.GPL included in the
33 ** packaging of this file. Please review the following information to
34 ** ensure the GNU General Public License version 3.0 requirements will be
35 ** met: http://www.gnu.org/copyleft/gpl.html.
36 **
37 **
38 ** $QT_END_LICENSE$
39 **
40 ****************************************************************************/
41 
42 #ifndef QRUBBERBAND_H
43 #define QRUBBERBAND_H
44 
45 #include <QtGui/qwidget.h>
46 
48 
50 
51 QT_MODULE(Gui)
52 
53 #ifndef QT_NO_RUBBERBAND
54 
55 class QRubberBandPrivate;
57 
59 {
60  Q_OBJECT
61 
62 public:
63  enum Shape { Line, Rectangle };
64  explicit QRubberBand(Shape, QWidget * =0);
65  ~QRubberBand();
66 
67  Shape shape() const;
68 
69  void setGeometry(const QRect &r);
70 
71  inline void setGeometry(int x, int y, int w, int h);
72  inline void move(int x, int y);
73  inline void move(const QPoint &p)
74  { move(p.x(), p.y()); }
75  inline void resize(int w, int h)
76  { setGeometry(geometry().x(), geometry().y(), w, h); }
77  inline void resize(const QSize &s)
78  { resize(s.width(), s.height()); }
79 
80 protected:
81  bool event(QEvent *e);
82  void paintEvent(QPaintEvent *);
83  void changeEvent(QEvent *);
84  void showEvent(QShowEvent *);
85  void resizeEvent(QResizeEvent *);
86  void moveEvent(QMoveEvent *);
87  void initStyleOption(QStyleOptionRubberBand *option) const;
88 
89 private:
91 };
92 
93 inline void QRubberBand::setGeometry(int ax, int ay, int aw, int ah)
94 { setGeometry(QRect(ax, ay, aw, ah)); }
95 inline void QRubberBand::move(int ax, int ay)
96 { setGeometry(ax, ay, width(), height()); }
97 
98 #endif // QT_NO_RUBBERBAND
99 
101 
103 
104 #endif // QRUBBERBAND_H
virtual void showEvent(QShowEvent *)
This event handler can be reimplemented in a subclass to receive widget show events which are passed ...
Definition: qwidget.cpp:9842
int y() const
#define QT_END_NAMESPACE
This macro expands to.
Definition: qglobal.h:90
#define QT_MODULE(x)
Definition: qglobal.h:2783
#define QT_BEGIN_HEADER
Definition: qglobal.h:136
#define Q_GUI_EXPORT
Definition: qglobal.h:1450
The QWidget class is the base class of all user interface objects.
Definition: qwidget.h:150
virtual void resizeEvent(QResizeEvent *)
This event handler can be reimplemented in a subclass to receive widget resize events which are passe...
Definition: qwidget.cpp:9587
virtual void moveEvent(QMoveEvent *)
This event handler can be reimplemented in a subclass to receive widget move events which are passed ...
Definition: qwidget.cpp:9566
void setGeometry(int x, int y, int w, int h)
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: qwidget.h:1017
int height() const
Shape
This enum specifies what shape a QRubberBand should have.
Definition: qrubberband.h:63
virtual void paintEvent(QPaintEvent *)
This event handler can be reimplemented in a subclass to receive paint events passed in event...
Definition: qwidget.cpp:9548
int width() const
Returns the width.
Definition: qsize.h:126
#define QT_BEGIN_NAMESPACE
This macro expands to.
Definition: qglobal.h:89
void setGeometry(const QRect &r)
Sets the geometry of the rubber band to rect, specified in the coordinate system of its parent widget...
The QMoveEvent class contains event parameters for move events.
Definition: qevent.h:334
The Rectangle item provides a filled rectangle with an optional border.
int width() const
virtual void changeEvent(QEvent *)
This event handler can be reimplemented to handle state changes.
Definition: qwidget.cpp:9170
The QResizeEvent class contains event parameters for resize events.
Definition: qevent.h:349
void move(const QPoint &p)
Moves the rubberband to point p.
Definition: qrubberband.h:73
The QShowEvent class provides an event that is sent when a widget is shown.
Definition: qevent.h:380
The QStyleOptionRubberBand class is used to describe the parameters needed for drawing a rubber band...
Definition: qstyleoption.h:669
#define Q_OBJECT
Definition: qobjectdefs.h:157
void move(int x, int y)
Moves the rubberband to point (x, y).
Definition: qrubberband.h:95
int x() const
void resize(int w, int h)
This corresponds to resize(QSize(w, h)).
Definition: qwidget.h:1014
The QPoint class defines a point in the plane using integer precision.
Definition: qpoint.h:53
int height() const
Returns the height.
Definition: qsize.h:129
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
void resize(int w, int h)
Resizes the rubberband so that its width is width, and its height is height.
Definition: qrubberband.h:75
int y() const
Returns the y coordinate of this point.
Definition: qpoint.h:131
void resize(const QSize &s)
Resizes the rubberband so that its new size is size.
Definition: qrubberband.h:77
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53
#define Q_DECLARE_PRIVATE(Class)
Definition: qglobal.h:2467
int x() const
Returns the x coordinate of this point.
Definition: qpoint.h:128
bool event(QEvent *)
This is the main event handler; it handles event event.
Definition: qwidget.cpp:8636
const QRect & geometry() const
The QPaintEvent class contains event parameters for paint events.
Definition: qevent.h:298
The QEvent class is the base class of all event classes.
Definition: qcoreevent.h:56
The QRubberBand class provides a rectangle or line that can indicate a selection or a boundary...
Definition: qrubberband.h:58
#define QT_END_HEADER
Definition: qglobal.h:137
void move(int x, int y)
This corresponds to move(QPoint(x, y)).
Definition: qwidget.h:1011