source: trunk/src/gui/painting/qregion.h@ 10

Last change on this file since 10 was 2, checked in by Dmitry A. Kuminov, 16 years ago

Initially imported qt-all-opensource-src-4.5.1 from Trolltech.
File size: 8.0 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
4** Contact: Qt Software Information (qt-info@nokia.com)
5**
6** This file is part of the QtGui module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial Usage
10** Licensees holding valid Qt Commercial licenses may use this file in
11** accordance with the Qt Commercial License Agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and Nokia.
14**
15** GNU Lesser General Public License Usage
16** Alternatively, this file may be used under the terms of the GNU Lesser
17** General Public License version 2.1 as published by the Free Software
18** Foundation and appearing in the file LICENSE.LGPL included in the
19** packaging of this file. Please review the following information to
20** ensure the GNU Lesser General Public License version 2.1 requirements
21** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
22**
23** In addition, as a special exception, Nokia gives you certain
24** additional rights. These rights are described in the Nokia Qt LGPL
25** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this
26** package.
27**
28** GNU General Public License Usage
29** Alternatively, this file may be used under the terms of the GNU
30** General Public License version 3.0 as published by the Free Software
31** Foundation and appearing in the file LICENSE.GPL included in the
32** packaging of this file. Please review the following information to
33** ensure the GNU General Public License version 3.0 requirements will be
34** met: http://www.gnu.org/copyleft/gpl.html.
35**
36** If you are unsure which license is appropriate for your use, please
37** contact the sales department at qt-sales@nokia.com.
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42#ifndef QREGION_H
43#define QREGION_H
44
45#include <QtCore/qatomic.h>
46#include <QtCore/qrect.h>
47#include <QtGui/qwindowdefs.h>
48
49#ifndef QT_NO_DATASTREAM
50#include <QtCore/qdatastream.h>
51#endif
52
53QT_BEGIN_HEADER
54
55QT_BEGIN_NAMESPACE
56
57QT_MODULE(Gui)
58
59template <class T> class QVector;
60class QVariant;
61
62#if defined(Q_WS_QWS) || defined(Q_WS_X11) || defined(Q_WS_MAC) || defined(Q_OS_WINCE)
63struct QRegionPrivate;
64#endif
65
66class QBitmap;
67
68class Q_GUI_EXPORT QRegion
69{
70public:
71 enum RegionType { Rectangle, Ellipse };
72
73 QRegion();
74 QRegion(int x, int y, int w, int h, RegionType t = Rectangle);
75 QRegion(const QRect &r, RegionType t = Rectangle);
76 QRegion(const QPolygon &pa, Qt::FillRule fillRule = Qt::OddEvenFill);
77#ifdef QT3_SUPPORT
78 QT3_SUPPORT_CONSTRUCTOR QRegion(const QPolygon &pa, bool winding);
79#endif
80 QRegion(const QRegion &region);
81 QRegion(const QBitmap &bitmap);
82 ~QRegion();
83 QRegion &operator=(const QRegion &);
84
85#ifdef QT3_SUPPORT
86 inline QT3_SUPPORT bool isNull() const { return isEmpty(); }
87#endif
88 bool isEmpty() const;
89
90 bool contains(const QPoint &p) const;
91 bool contains(const QRect &r) const;
92
93 void translate(int dx, int dy);
94 inline void translate(const QPoint &p) { translate(p.x(), p.y()); }
95 QRegion translated(int dx, int dy) const;
96 inline QRegion translated(const QPoint &p) const { return translated(p.x(), p.y()); }
97
98 // ### Qt 5: make these four functions QT4_SUPPORT
99 QRegion unite(const QRegion &r) const;
100 QRegion unite(const QRect &r) const;
101 QRegion intersect(const QRegion &r) const;
102 QRegion intersect(const QRect &r) const;
103 QRegion subtract(const QRegion &r) const;
104 QRegion eor(const QRegion &r) const;
105
106 inline QRegion united(const QRegion &r) const { return unite(r); }
107 inline QRegion united(const QRect &r) const { return unite(r); }
108 inline QRegion intersected(const QRegion &r) const { return intersect(r); }
109 inline QRegion intersected(const QRect &r) const { return intersect(r); }
110 inline QRegion subtracted(const QRegion &r) const { return subtract(r); }
111 inline QRegion xored(const QRegion &r) const { return eor(r); }
112
113 bool intersects(const QRegion &r) const;
114 bool intersects(const QRect &r) const;
115
116 QRect boundingRect() const;
117 QVector<QRect> rects() const;
118 void setRects(const QRect *rect, int num);
119 int numRects() const;
120
121 const QRegion operator|(const QRegion &r) const;
122 const QRegion operator+(const QRegion &r) const;
123 const QRegion operator+(const QRect &r) const;
124 const QRegion operator&(const QRegion &r) const;
125 const QRegion operator&(const QRect &r) const;
126 const QRegion operator-(const QRegion &r) const;
127 const QRegion operator^(const QRegion &r) const;
128 QRegion& operator|=(const QRegion &r);
129 QRegion& operator+=(const QRegion &r);
130 QRegion& operator+=(const QRect &r);
131 QRegion& operator&=(const QRegion &r);
132 QRegion& operator&=(const QRect &r);
133 QRegion& operator-=(const QRegion &r);
134 QRegion& operator^=(const QRegion &r);
135
136 bool operator==(const QRegion &r) const;
137 inline bool operator!=(const QRegion &r) const { return !(operator==(r)); }
138 operator QVariant() const;
139
140#ifdef qdoc
141 Handle handle() const;
142#endif
143#ifndef qdoc
144#if defined(Q_WS_WIN)
145 inline HRGN handle() const { ensureHandle(); return d->rgn; }
146#elif defined(Q_WS_X11)
147 inline Region handle() const { if(!d->rgn) updateX11Region(); return d->rgn; }
148#elif defined(Q_WS_MAC)
149#if defined Q_WS_MAC32
150 RgnHandle toQDRgn() const;
151 static QRegion fromQDRgn(RgnHandle shape);
152#endif
153#ifdef QT_MAC_USE_COCOA
154 inline HIMutableShapeRef handle(bool unused = false) const
155 { Q_UNUSED(unused); return toHIMutableShape(); }
156#else
157 inline RgnHandle handle() const { return handle(false); }
158 inline RgnHandle handle(bool) const { return toQDRgn(); }
159#endif
160 HIMutableShapeRef toHIMutableShape() const;
161 static QRegion fromHIShapeRef(HIShapeRef shape);
162#elif defined(Q_WS_QWS)
163 inline void *handle() const { return d->qt_rgn; }
164#endif
165#endif
166
167#ifndef QT_NO_DATASTREAM
168 friend Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QRegion &);
169 friend Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QRegion &);
170#endif
171private:
172 QRegion copy() const; // helper of detach.
173 void detach();
174#if defined(Q_WS_WIN)
175 void ensureHandle() const;
176 QRegion winCombine(const QRegion &r, int num) const;
177#elif defined(Q_WS_X11)
178 void updateX11Region() const;
179 void *clipRectangles(int &num) const;
180 friend void *qt_getClipRects(const QRegion &r, int &num);
181#elif defined(Q_WS_MAC)
182 static OSStatus shape2QRegionHelper(int inMessage, HIShapeRef inShape,
183 const CGRect *inRect, void *inRefcon);
184#endif
185 friend bool qt_region_strictContains(const QRegion &region,
186 const QRect &rect);
187 friend struct QRegionPrivate;
188
189#ifndef QT_NO_DATASTREAM
190 void exec(const QByteArray &ba, int ver = 0, QDataStream::ByteOrder byteOrder = QDataStream::BigEndian);
191#endif
192 struct QRegionData {
193 QBasicAtomicInt ref;
194#if defined(Q_WS_WIN)
195 HRGN rgn;
196#elif defined(Q_WS_X11)
197 Region rgn;
198 void *xrectangles;
199#elif defined(Q_WS_MAC) && !defined(QT_MAC_USE_COCOA)
200 mutable RgnHandle unused; // Here for binary compatability reasons. ### Qt 5 remove.
201#endif
202#if defined(Q_WS_QWS) || defined(Q_WS_X11) || defined(Q_WS_MAC) || defined(Q_OS_WINCE)
203 QRegionPrivate *qt_rgn;
204#endif
205 };
206#if defined(Q_WS_WIN)
207 friend class QETWidget;
208#endif
209 struct QRegionData *d;
210 static struct QRegionData shared_empty;
211 static void cleanUp(QRegionData *x);
212};
213
214/*****************************************************************************
215 QRegion stream functions
216 *****************************************************************************/
217
218#ifndef QT_NO_DATASTREAM
219Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QRegion &);
220Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QRegion &);
221#endif
222
223#ifndef QT_NO_DEBUG_STREAM
224Q_GUI_EXPORT QDebug operator<<(QDebug, const QRegion &);
225#endif
226
227QT_END_NAMESPACE
228
229QT_END_HEADER
230
231#endif // QREGION_H
Note: See TracBrowser for help on using the repository browser.