source: trunk/doc/html/qregion-h.html@ 208

Last change on this file since 208 was 190, checked in by rudi, 14 years ago

reference documentation added

File size: 7.4 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qregion.h:1 -->
3<html>
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6<title>qregion.h Include File</title>
7<style type="text/css"><!--
8fn { margin-left: 1cm; text-indent: -1cm; }
9a:link { color: #004faf; text-decoration: none }
10a:visited { color: #672967; text-decoration: none }
11body { background: #ffffff; color: black; }
12--></style>
13</head>
14<body>
15
16<table border="0" cellpadding="0" cellspacing="0" width="100%">
17<tr bgcolor="#E5E5E5">
18<td valign=center>
19 <a href="index.html">
20<font color="#004faf">Home</font></a>
21 | <a href="classes.html">
22<font color="#004faf">All&nbsp;Classes</font></a>
23 | <a href="mainclasses.html">
24<font color="#004faf">Main&nbsp;Classes</font></a>
25 | <a href="annotated.html">
26<font color="#004faf">Annotated</font></a>
27 | <a href="groups.html">
28<font color="#004faf">Grouped&nbsp;Classes</font></a>
29 | <a href="functions.html">
30<font color="#004faf">Functions</font></a>
31</td>
32<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qregion.h</h1>
33
34<p>This is the verbatim text of the qregion.h include file. It is provided only for illustration; the copyright remains with Trolltech.
35<hr>
36<pre>
37/****************************************************************************
38** $Id: qregion-h.html 2051 2007-02-21 10:04:20Z chehrlic $
39**
40** Definition of QRegion class
41**
42** Created : 940514
43**
44** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved.
45**
46** This file is part of the kernel module of the Qt GUI Toolkit.
47**
48** This file may be distributed under the terms of the Q Public License
49** as defined by Trolltech ASA of Norway and appearing in the file
50** LICENSE.QPL included in the packaging of this file.
51**
52** This file may be distributed and/or modified under the terms of the
53** GNU General Public License version 2 as published by the Free Software
54** Foundation and appearing in the file LICENSE.GPL included in the
55** packaging of this file.
56**
57** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
58** licenses may use this file in accordance with the Qt Commercial License
59** Agreement provided with the Software.
60**
61** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
62** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
63**
64** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
65** information about Qt Commercial License Agreements.
66** See http://www.trolltech.com/qpl/ for QPL licensing information.
67** See http://www.trolltech.com/gpl/ for GPL licensing information.
68**
69** Contact info@trolltech.com if any conditions of this licensing are
70** not clear to you.
71**
72**********************************************************************/
73
74#ifndef QREGION_H
75#define QREGION_H
76
77#ifndef QT_H
78#include "qshared.h"
79#include "qrect.h"
80#endif // QT_H
81
82#ifdef Q_WS_X11
83struct QRegionPrivate;
84#endif
85
86class Q_EXPORT QRegion
87{
88public:
89 enum RegionType { Rectangle, Ellipse };
90
91 QRegion();
92 QRegion( int x, int y, int w, int h, RegionType = Rectangle );
93 QRegion( const QRect &amp;, RegionType = Rectangle );
94 QRegion( const QPointArray &amp;, bool winding=FALSE );
95 QRegion( const QRegion &amp; );
96 QRegion( const QBitmap &amp; );
97 ~QRegion();
98 QRegion &amp;operator=( const QRegion &amp; );
99
100 bool isNull() const;
101 bool isEmpty() const;
102
103 bool contains( const QPoint &amp;p ) const;
104 bool contains( const QRect &amp;r ) const;
105
106 void translate( int dx, int dy );
107
108 QRegion unite( const QRegion &amp; ) const;
109 QRegion intersect( const QRegion &amp;) const;
110 QRegion subtract( const QRegion &amp; ) const;
111 QRegion eor( const QRegion &amp; ) const;
112
113 QRect boundingRect() const;
114 QMemArray&lt;QRect&gt; rects() const;
115 void setRects( const QRect *, int );
116
117 const QRegion operator|( const QRegion &amp; ) const;
118 const QRegion operator+( const QRegion &amp; ) const;
119 const QRegion operator&amp;( const QRegion &amp; ) const;
120 const QRegion operator-( const QRegion &amp; ) const;
121 const QRegion operator^( const QRegion &amp; ) const;
122 QRegion&amp; operator|=( const QRegion &amp; );
123 QRegion&amp; operator+=( const QRegion &amp; );
124 QRegion&amp; operator&amp;=( const QRegion &amp; );
125 QRegion&amp; operator-=( const QRegion &amp; );
126 QRegion&amp; operator^=( const QRegion &amp; );
127
128 bool operator==( const QRegion &amp; ) const;
129 bool operator!=( const QRegion &amp;r ) const
130 { return !(operator==(r)); }
131
132#if defined(Q_WS_WIN)
133 HRGN handle() const { return data-&gt;rgn; }
134#elif defined(Q_WS_X11)
135 Region handle() const { if(!data-&gt;rgn) updateX11Region(); return data-&gt;rgn; }
136#elif defined(Q_WS_MAC)
137 RgnHandle handle(bool require_rgn=FALSE) const;
138#elif defined(Q_WS_QWS)
139 // QGfx_QWS needs this for region drawing
140 void * handle() const { return data-&gt;rgn; }
141#endif
142
143#ifndef QT_NO_DATASTREAM
144 friend Q_EXPORT QDataStream &amp;operator&lt;&lt;( QDataStream &amp;, const QRegion &amp; );
145 friend Q_EXPORT QDataStream &amp;operator&gt;&gt;( QDataStream &amp;, QRegion &amp; );
146#endif
147private:
148 QRegion( bool );
149 QRegion copy() const;
150 void detach();
151#if defined(Q_WS_WIN)
152 QRegion winCombine( const QRegion &amp;, int ) const;
153#endif
154#if defined(Q_WS_X11)
155 void updateX11Region() const;
156 void *clipRectangles( int &amp;num ) const;
157 friend void *qt_getClipRects( const QRegion &amp;, int &amp; );
158#endif
159 void exec( const QByteArray &amp;, int ver = 0 );
160 struct QRegionData : public QShared {
161#if defined(Q_WS_WIN)
162 HRGN rgn;
163#elif defined(Q_WS_X11)
164 Region rgn;
165 void *xrectangles;
166 QRegionPrivate *region;
167#elif defined(Q_WS_MAC)
168 uint is_rect:1;
169 QRect rect;
170 RgnHandle rgn;
171#elif defined(Q_WS_QWS)
172 void * rgn;
173#endif
174 bool is_null;
175 } *data;
176#if defined(Q_WS_MAC)
177 friend struct qt_mac_rgn_data_cache;
178 friend QRegionData *qt_mac_get_rgn_data();
179 friend void qt_mac_free_rgn_data(QRegionData *);
180 void rectifyRegion();
181#elif defined(Q_WS_WIN)
182 friend class QETWidget;
183#endif
184
185};
186
187
188#define QRGN_SETRECT 1 // region stream commands
189#define QRGN_SETELLIPSE 2 // (these are internal)
190#define QRGN_SETPTARRAY_ALT 3
191#define QRGN_SETPTARRAY_WIND 4
192#define QRGN_TRANSLATE 5
193#define QRGN_OR 6
194#define QRGN_AND 7
195#define QRGN_SUB 8
196#define QRGN_XOR 9
197#define QRGN_RECTS 10
198
199
200/*****************************************************************************
201 QRegion stream functions
202 *****************************************************************************/
203
204#ifndef QT_NO_DATASTREAM
205Q_EXPORT QDataStream &amp;operator&lt;&lt;( QDataStream &amp;, const QRegion &amp; );
206Q_EXPORT QDataStream &amp;operator&gt;&gt;( QDataStream &amp;, QRegion &amp; );
207#endif
208
209
210#endif // QREGION_H
211</pre>
212<!-- eof -->
213<p><address><hr><div align=center>
214<table width=100% cellspacing=0 border=0><tr>
215<td>Copyright &copy; 2007
216<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
217<td align=right><div align=right>Qt 3.3.8</div>
218</table></div></address></body>
219</html>
Note: See TracBrowser for help on using the repository browser.