1 | // Copyright (C) 2022 The Qt Company Ltd. |
---|---|
2 | // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only |
3 | |
4 | #ifndef QRECT_H |
5 | #define QRECT_H |
6 | |
7 | #include <QtCore/qhashfunctions.h> |
8 | #include <QtCore/qmargins.h> |
9 | #include <QtCore/qsize.h> |
10 | #include <QtCore/qpoint.h> |
11 | |
12 | #ifdef topLeft |
13 | #error qrect.h must be included before any header file that defines topLeft |
14 | #endif |
15 | |
16 | #if defined(Q_OS_DARWIN) || defined(Q_QDOC) |
17 | struct CGRect; |
18 | #endif |
19 | #if defined(Q_OS_WASM) || defined(Q_QDOC) |
20 | namespace emscripten { |
21 | class val; |
22 | } |
23 | #endif |
24 | |
25 | QT_BEGIN_NAMESPACE |
26 | |
27 | class QRectF; |
28 | |
29 | class Q_CORE_EXPORT QRect |
30 | { |
31 | public: |
32 | constexpr QRect() noexcept : x1(0), y1(0), x2(-1), y2(-1) {} |
33 | constexpr QRect(const QPoint &topleft, const QPoint &bottomright) noexcept; |
34 | constexpr QRect(const QPoint &topleft, const QSize &size) noexcept; |
35 | constexpr QRect(int left, int top, int width, int height) noexcept; |
36 | |
37 | constexpr inline bool isNull() const noexcept; |
38 | constexpr inline bool isEmpty() const noexcept; |
39 | constexpr inline bool isValid() const noexcept; |
40 | |
41 | constexpr inline int left() const noexcept; |
42 | constexpr inline int top() const noexcept; |
43 | constexpr inline int right() const noexcept; |
44 | constexpr inline int bottom() const noexcept; |
45 | [[nodiscard]] QRect normalized() const noexcept; |
46 | |
47 | constexpr inline int x() const noexcept; |
48 | constexpr inline int y() const noexcept; |
49 | constexpr inline void setLeft(int pos) noexcept; |
50 | constexpr inline void setTop(int pos) noexcept; |
51 | constexpr inline void setRight(int pos) noexcept; |
52 | constexpr inline void setBottom(int pos) noexcept; |
53 | constexpr inline void setX(int x) noexcept; |
54 | constexpr inline void setY(int y) noexcept; |
55 | |
56 | constexpr inline void setTopLeft(const QPoint &p) noexcept; |
57 | constexpr inline void setBottomRight(const QPoint &p) noexcept; |
58 | constexpr inline void setTopRight(const QPoint &p) noexcept; |
59 | constexpr inline void setBottomLeft(const QPoint &p) noexcept; |
60 | |
61 | constexpr inline QPoint topLeft() const noexcept; |
62 | constexpr inline QPoint bottomRight() const noexcept; |
63 | constexpr inline QPoint topRight() const noexcept; |
64 | constexpr inline QPoint bottomLeft() const noexcept; |
65 | constexpr inline QPoint center() const noexcept; |
66 | |
67 | constexpr inline void moveLeft(int pos) noexcept; |
68 | constexpr inline void moveTop(int pos) noexcept; |
69 | constexpr inline void moveRight(int pos) noexcept; |
70 | constexpr inline void moveBottom(int pos) noexcept; |
71 | constexpr inline void moveTopLeft(const QPoint &p) noexcept; |
72 | constexpr inline void moveBottomRight(const QPoint &p) noexcept; |
73 | constexpr inline void moveTopRight(const QPoint &p) noexcept; |
74 | constexpr inline void moveBottomLeft(const QPoint &p) noexcept; |
75 | constexpr inline void moveCenter(const QPoint &p) noexcept; |
76 | |
77 | constexpr inline void translate(int dx, int dy) noexcept; |
78 | constexpr inline void translate(const QPoint &p) noexcept; |
79 | [[nodiscard]] constexpr inline QRect translated(int dx, int dy) const noexcept; |
80 | [[nodiscard]] constexpr inline QRect translated(const QPoint &p) const noexcept; |
81 | [[nodiscard]] constexpr inline QRect transposed() const noexcept; |
82 | |
83 | constexpr inline void moveTo(int x, int t) noexcept; |
84 | constexpr inline void moveTo(const QPoint &p) noexcept; |
85 | |
86 | constexpr inline void setRect(int x, int y, int w, int h) noexcept; |
87 | constexpr inline void getRect(int *x, int *y, int *w, int *h) const; |
88 | |
89 | constexpr inline void setCoords(int x1, int y1, int x2, int y2) noexcept; |
90 | constexpr inline void getCoords(int *x1, int *y1, int *x2, int *y2) const; |
91 | |
92 | constexpr inline void adjust(int x1, int y1, int x2, int y2) noexcept; |
93 | [[nodiscard]] constexpr inline QRect adjusted(int x1, int y1, int x2, int y2) const noexcept; |
94 | |
95 | constexpr inline QSize size() const noexcept; |
96 | constexpr inline int width() const noexcept; |
97 | constexpr inline int height() const noexcept; |
98 | constexpr inline void setWidth(int w) noexcept; |
99 | constexpr inline void setHeight(int h) noexcept; |
100 | constexpr inline void setSize(const QSize &s) noexcept; |
101 | |
102 | QRect operator|(const QRect &r) const noexcept; |
103 | QRect operator&(const QRect &r) const noexcept; |
104 | inline QRect &operator|=(const QRect &r) noexcept; |
105 | inline QRect &operator&=(const QRect &r) noexcept; |
106 | |
107 | bool contains(const QRect &r, bool proper = false) const noexcept; |
108 | bool contains(const QPoint &p, bool proper = false) const noexcept; |
109 | inline bool contains(int x, int y) const noexcept; |
110 | inline bool contains(int x, int y, bool proper) const noexcept; |
111 | [[nodiscard]] inline QRect united(const QRect &other) const noexcept; |
112 | [[nodiscard]] inline QRect intersected(const QRect &other) const noexcept; |
113 | bool intersects(const QRect &r) const noexcept; |
114 | |
115 | constexpr inline QRect marginsAdded(const QMargins &margins) const noexcept; |
116 | constexpr inline QRect marginsRemoved(const QMargins &margins) const noexcept; |
117 | constexpr inline QRect &operator+=(const QMargins &margins) noexcept; |
118 | constexpr inline QRect &operator-=(const QMargins &margins) noexcept; |
119 | |
120 | [[nodiscard]] static constexpr inline QRect span(const QPoint &p1, const QPoint &p2) noexcept; |
121 | |
122 | private: |
123 | friend constexpr bool comparesEqual(const QRect &r1, const QRect &r2) noexcept |
124 | { return r1.x1==r2.x1 && r1.x2==r2.x2 && r1.y1==r2.y1 && r1.y2==r2.y2; } |
125 | Q_DECLARE_EQUALITY_COMPARABLE_LITERAL_TYPE(QRect) |
126 | friend constexpr inline size_t qHash(const QRect &, size_t) noexcept; |
127 | |
128 | public: |
129 | #if defined(Q_OS_DARWIN) || defined(Q_QDOC) |
130 | [[nodiscard]] CGRect toCGRect() const noexcept; |
131 | #endif |
132 | [[nodiscard]] constexpr inline QRectF toRectF() const noexcept; |
133 | |
134 | private: |
135 | int x1; |
136 | int y1; |
137 | int x2; |
138 | int y2; |
139 | }; |
140 | Q_DECLARE_TYPEINFO(QRect, Q_RELOCATABLE_TYPE); |
141 | |
142 | |
143 | /***************************************************************************** |
144 | QRect stream functions |
145 | *****************************************************************************/ |
146 | #ifndef QT_NO_DATASTREAM |
147 | Q_CORE_EXPORT QDataStream &operator<<(QDataStream &, const QRect &); |
148 | Q_CORE_EXPORT QDataStream &operator>>(QDataStream &, QRect &); |
149 | #endif |
150 | |
151 | /***************************************************************************** |
152 | QRect inline member functions |
153 | *****************************************************************************/ |
154 | |
155 | constexpr inline QRect::QRect(int aleft, int atop, int awidth, int aheight) noexcept |
156 | : x1(aleft), y1(atop), x2(aleft + awidth - 1), y2(atop + aheight - 1) {} |
157 | |
158 | constexpr inline QRect::QRect(const QPoint &atopLeft, const QPoint &abottomRight) noexcept |
159 | : x1(atopLeft.x()), y1(atopLeft.y()), x2(abottomRight.x()), y2(abottomRight.y()) {} |
160 | |
161 | constexpr inline QRect::QRect(const QPoint &atopLeft, const QSize &asize) noexcept |
162 | : x1(atopLeft.x()), y1(atopLeft.y()), x2(atopLeft.x()+asize.width() - 1), y2(atopLeft.y()+asize.height() - 1) {} |
163 | |
164 | constexpr inline bool QRect::isNull() const noexcept |
165 | { return x2 == x1 - 1 && y2 == y1 - 1; } |
166 | |
167 | constexpr inline bool QRect::isEmpty() const noexcept |
168 | { return x1 > x2 || y1 > y2; } |
169 | |
170 | constexpr inline bool QRect::isValid() const noexcept |
171 | { return x1 <= x2 && y1 <= y2; } |
172 | |
173 | constexpr inline int QRect::left() const noexcept |
174 | { return x1; } |
175 | |
176 | constexpr inline int QRect::top() const noexcept |
177 | { return y1; } |
178 | |
179 | constexpr inline int QRect::right() const noexcept |
180 | { return x2; } |
181 | |
182 | constexpr inline int QRect::bottom() const noexcept |
183 | { return y2; } |
184 | |
185 | constexpr inline int QRect::x() const noexcept |
186 | { return x1; } |
187 | |
188 | constexpr inline int QRect::y() const noexcept |
189 | { return y1; } |
190 | |
191 | constexpr inline void QRect::setLeft(int pos) noexcept |
192 | { x1 = pos; } |
193 | |
194 | constexpr inline void QRect::setTop(int pos) noexcept |
195 | { y1 = pos; } |
196 | |
197 | constexpr inline void QRect::setRight(int pos) noexcept |
198 | { x2 = pos; } |
199 | |
200 | constexpr inline void QRect::setBottom(int pos) noexcept |
201 | { y2 = pos; } |
202 | |
203 | constexpr inline void QRect::setTopLeft(const QPoint &p) noexcept |
204 | { x1 = p.x(); y1 = p.y(); } |
205 | |
206 | constexpr inline void QRect::setBottomRight(const QPoint &p) noexcept |
207 | { x2 = p.x(); y2 = p.y(); } |
208 | |
209 | constexpr inline void QRect::setTopRight(const QPoint &p) noexcept |
210 | { x2 = p.x(); y1 = p.y(); } |
211 | |
212 | constexpr inline void QRect::setBottomLeft(const QPoint &p) noexcept |
213 | { x1 = p.x(); y2 = p.y(); } |
214 | |
215 | constexpr inline void QRect::setX(int ax) noexcept |
216 | { x1 = ax; } |
217 | |
218 | constexpr inline void QRect::setY(int ay) noexcept |
219 | { y1 = ay; } |
220 | |
221 | constexpr inline QPoint QRect::topLeft() const noexcept |
222 | { return QPoint(x1, y1); } |
223 | |
224 | constexpr inline QPoint QRect::bottomRight() const noexcept |
225 | { return QPoint(x2, y2); } |
226 | |
227 | constexpr inline QPoint QRect::topRight() const noexcept |
228 | { return QPoint(x2, y1); } |
229 | |
230 | constexpr inline QPoint QRect::bottomLeft() const noexcept |
231 | { return QPoint(x1, y2); } |
232 | |
233 | constexpr inline QPoint QRect::center() const noexcept |
234 | { return QPoint(int((qint64(x1)+x2)/2), int((qint64(y1)+y2)/2)); } // cast avoids overflow on addition |
235 | |
236 | constexpr inline int QRect::width() const noexcept |
237 | { return x2 - x1 + 1; } |
238 | |
239 | constexpr inline int QRect::height() const noexcept |
240 | { return y2 - y1 + 1; } |
241 | |
242 | constexpr inline QSize QRect::size() const noexcept |
243 | { return QSize(width(), height()); } |
244 | |
245 | constexpr inline void QRect::translate(int dx, int dy) noexcept |
246 | { |
247 | x1 += dx; |
248 | y1 += dy; |
249 | x2 += dx; |
250 | y2 += dy; |
251 | } |
252 | |
253 | constexpr inline void QRect::translate(const QPoint &p) noexcept |
254 | { |
255 | x1 += p.x(); |
256 | y1 += p.y(); |
257 | x2 += p.x(); |
258 | y2 += p.y(); |
259 | } |
260 | |
261 | constexpr inline QRect QRect::translated(int dx, int dy) const noexcept |
262 | { return QRect(QPoint(x1 + dx, y1 + dy), QPoint(x2 + dx, y2 + dy)); } |
263 | |
264 | constexpr inline QRect QRect::translated(const QPoint &p) const noexcept |
265 | { return QRect(QPoint(x1 + p.x(), y1 + p.y()), QPoint(x2 + p.x(), y2 + p.y())); } |
266 | |
267 | constexpr inline QRect QRect::transposed() const noexcept |
268 | { return QRect(topLeft(), size().transposed()); } |
269 | |
270 | constexpr inline void QRect::moveTo(int ax, int ay) noexcept |
271 | { |
272 | x2 += ax - x1; |
273 | y2 += ay - y1; |
274 | x1 = ax; |
275 | y1 = ay; |
276 | } |
277 | |
278 | constexpr inline void QRect::moveTo(const QPoint &p) noexcept |
279 | { |
280 | x2 += p.x() - x1; |
281 | y2 += p.y() - y1; |
282 | x1 = p.x(); |
283 | y1 = p.y(); |
284 | } |
285 | |
286 | constexpr inline void QRect::moveLeft(int pos) noexcept |
287 | { x2 += (pos - x1); x1 = pos; } |
288 | |
289 | constexpr inline void QRect::moveTop(int pos) noexcept |
290 | { y2 += (pos - y1); y1 = pos; } |
291 | |
292 | constexpr inline void QRect::moveRight(int pos) noexcept |
293 | { |
294 | x1 += (pos - x2); |
295 | x2 = pos; |
296 | } |
297 | |
298 | constexpr inline void QRect::moveBottom(int pos) noexcept |
299 | { |
300 | y1 += (pos - y2); |
301 | y2 = pos; |
302 | } |
303 | |
304 | constexpr inline void QRect::moveTopLeft(const QPoint &p) noexcept |
305 | { |
306 | moveLeft(pos: p.x()); |
307 | moveTop(pos: p.y()); |
308 | } |
309 | |
310 | constexpr inline void QRect::moveBottomRight(const QPoint &p) noexcept |
311 | { |
312 | moveRight(pos: p.x()); |
313 | moveBottom(pos: p.y()); |
314 | } |
315 | |
316 | constexpr inline void QRect::moveTopRight(const QPoint &p) noexcept |
317 | { |
318 | moveRight(pos: p.x()); |
319 | moveTop(pos: p.y()); |
320 | } |
321 | |
322 | constexpr inline void QRect::moveBottomLeft(const QPoint &p) noexcept |
323 | { |
324 | moveLeft(pos: p.x()); |
325 | moveBottom(pos: p.y()); |
326 | } |
327 | |
328 | constexpr inline void QRect::moveCenter(const QPoint &p) noexcept |
329 | { |
330 | int w = x2 - x1; |
331 | int h = y2 - y1; |
332 | x1 = p.x() - w/2; |
333 | y1 = p.y() - h/2; |
334 | x2 = x1 + w; |
335 | y2 = y1 + h; |
336 | } |
337 | |
338 | constexpr inline void QRect::getRect(int *ax, int *ay, int *aw, int *ah) const |
339 | { |
340 | *ax = x1; |
341 | *ay = y1; |
342 | *aw = x2 - x1 + 1; |
343 | *ah = y2 - y1 + 1; |
344 | } |
345 | |
346 | constexpr inline void QRect::setRect(int ax, int ay, int aw, int ah) noexcept |
347 | { |
348 | x1 = ax; |
349 | y1 = ay; |
350 | x2 = (ax + aw - 1); |
351 | y2 = (ay + ah - 1); |
352 | } |
353 | |
354 | constexpr inline void QRect::getCoords(int *xp1, int *yp1, int *xp2, int *yp2) const |
355 | { |
356 | *xp1 = x1; |
357 | *yp1 = y1; |
358 | *xp2 = x2; |
359 | *yp2 = y2; |
360 | } |
361 | |
362 | constexpr inline void QRect::setCoords(int xp1, int yp1, int xp2, int yp2) noexcept |
363 | { |
364 | x1 = xp1; |
365 | y1 = yp1; |
366 | x2 = xp2; |
367 | y2 = yp2; |
368 | } |
369 | |
370 | constexpr inline QRect QRect::adjusted(int xp1, int yp1, int xp2, int yp2) const noexcept |
371 | { return QRect(QPoint(x1 + xp1, y1 + yp1), QPoint(x2 + xp2, y2 + yp2)); } |
372 | |
373 | constexpr inline void QRect::adjust(int dx1, int dy1, int dx2, int dy2) noexcept |
374 | { |
375 | x1 += dx1; |
376 | y1 += dy1; |
377 | x2 += dx2; |
378 | y2 += dy2; |
379 | } |
380 | |
381 | constexpr inline void QRect::setWidth(int w) noexcept |
382 | { x2 = (x1 + w - 1); } |
383 | |
384 | constexpr inline void QRect::setHeight(int h) noexcept |
385 | { y2 = (y1 + h - 1); } |
386 | |
387 | constexpr inline void QRect::setSize(const QSize &s) noexcept |
388 | { |
389 | x2 = (s.width() + x1 - 1); |
390 | y2 = (s.height() + y1 - 1); |
391 | } |
392 | |
393 | inline bool QRect::contains(int ax, int ay, bool aproper) const noexcept |
394 | { |
395 | return contains(p: QPoint(ax, ay), proper: aproper); |
396 | } |
397 | |
398 | inline bool QRect::contains(int ax, int ay) const noexcept |
399 | { |
400 | return contains(p: QPoint(ax, ay), proper: false); |
401 | } |
402 | |
403 | inline QRect &QRect::operator|=(const QRect &r) noexcept |
404 | { |
405 | *this = *this | r; |
406 | return *this; |
407 | } |
408 | |
409 | inline QRect &QRect::operator&=(const QRect &r) noexcept |
410 | { |
411 | *this = *this & r; |
412 | return *this; |
413 | } |
414 | |
415 | inline QRect QRect::intersected(const QRect &other) const noexcept |
416 | { |
417 | return *this & other; |
418 | } |
419 | |
420 | inline QRect QRect::united(const QRect &r) const noexcept |
421 | { |
422 | return *this | r; |
423 | } |
424 | |
425 | constexpr inline size_t qHash(const QRect &r, size_t seed = 0) noexcept |
426 | { |
427 | return qHashMulti(seed, args: r.x1, args: r.x2, args: r.y1, args: r.y2); |
428 | } |
429 | |
430 | constexpr inline QRect operator+(const QRect &rectangle, const QMargins &margins) noexcept |
431 | { |
432 | return QRect(QPoint(rectangle.left() - margins.left(), rectangle.top() - margins.top()), |
433 | QPoint(rectangle.right() + margins.right(), rectangle.bottom() + margins.bottom())); |
434 | } |
435 | |
436 | constexpr inline QRect operator+(const QMargins &margins, const QRect &rectangle) noexcept |
437 | { |
438 | return QRect(QPoint(rectangle.left() - margins.left(), rectangle.top() - margins.top()), |
439 | QPoint(rectangle.right() + margins.right(), rectangle.bottom() + margins.bottom())); |
440 | } |
441 | |
442 | constexpr inline QRect operator-(const QRect &lhs, const QMargins &rhs) noexcept |
443 | { |
444 | return QRect(QPoint(lhs.left() + rhs.left(), lhs.top() + rhs.top()), |
445 | QPoint(lhs.right() - rhs.right(), lhs.bottom() - rhs.bottom())); |
446 | } |
447 | |
448 | constexpr inline QRect QRect::marginsAdded(const QMargins &margins) const noexcept |
449 | { |
450 | return QRect(QPoint(x1 - margins.left(), y1 - margins.top()), |
451 | QPoint(x2 + margins.right(), y2 + margins.bottom())); |
452 | } |
453 | |
454 | constexpr inline QRect QRect::marginsRemoved(const QMargins &margins) const noexcept |
455 | { |
456 | return QRect(QPoint(x1 + margins.left(), y1 + margins.top()), |
457 | QPoint(x2 - margins.right(), y2 - margins.bottom())); |
458 | } |
459 | |
460 | constexpr inline QRect &QRect::operator+=(const QMargins &margins) noexcept |
461 | { |
462 | *this = marginsAdded(margins); |
463 | return *this; |
464 | } |
465 | |
466 | constexpr inline QRect &QRect::operator-=(const QMargins &margins) noexcept |
467 | { |
468 | *this = marginsRemoved(margins); |
469 | return *this; |
470 | } |
471 | |
472 | constexpr QRect QRect::span(const QPoint &p1, const QPoint &p2) noexcept |
473 | { |
474 | return QRect(QPoint(qMin(a: p1.x(), b: p2.x()), qMin(a: p1.y(), b: p2.y())), |
475 | QPoint(qMax(a: p1.x(), b: p2.x()), qMax(a: p1.y(), b: p2.y()))); |
476 | } |
477 | |
478 | #ifndef QT_NO_DEBUG_STREAM |
479 | Q_CORE_EXPORT QDebug operator<<(QDebug, const QRect &); |
480 | #endif |
481 | |
482 | |
483 | class Q_CORE_EXPORT QRectF |
484 | { |
485 | public: |
486 | constexpr QRectF() noexcept : xp(0.), yp(0.), w(0.), h(0.) {} |
487 | constexpr QRectF(const QPointF &topleft, const QSizeF &size) noexcept; |
488 | constexpr QRectF(const QPointF &topleft, const QPointF &bottomRight) noexcept; |
489 | constexpr QRectF(qreal left, qreal top, qreal width, qreal height) noexcept; |
490 | constexpr QRectF(const QRect &rect) noexcept; |
491 | |
492 | constexpr inline bool isNull() const noexcept; |
493 | constexpr inline bool isEmpty() const noexcept; |
494 | constexpr inline bool isValid() const noexcept; |
495 | [[nodiscard]] QRectF normalized() const noexcept; |
496 | |
497 | constexpr inline qreal left() const noexcept { return xp; } |
498 | constexpr inline qreal top() const noexcept { return yp; } |
499 | constexpr inline qreal right() const noexcept { return xp + w; } |
500 | constexpr inline qreal bottom() const noexcept { return yp + h; } |
501 | |
502 | constexpr inline qreal x() const noexcept; |
503 | constexpr inline qreal y() const noexcept; |
504 | constexpr inline void setLeft(qreal pos) noexcept; |
505 | constexpr inline void setTop(qreal pos) noexcept; |
506 | constexpr inline void setRight(qreal pos) noexcept; |
507 | constexpr inline void setBottom(qreal pos) noexcept; |
508 | constexpr inline void setX(qreal pos) noexcept { setLeft(pos); } |
509 | constexpr inline void setY(qreal pos) noexcept { setTop(pos); } |
510 | |
511 | constexpr inline QPointF topLeft() const noexcept { return QPointF(xp, yp); } |
512 | constexpr inline QPointF bottomRight() const noexcept { return QPointF(xp+w, yp+h); } |
513 | constexpr inline QPointF topRight() const noexcept { return QPointF(xp+w, yp); } |
514 | constexpr inline QPointF bottomLeft() const noexcept { return QPointF(xp, yp+h); } |
515 | constexpr inline QPointF center() const noexcept; |
516 | |
517 | constexpr inline void setTopLeft(const QPointF &p) noexcept; |
518 | constexpr inline void setBottomRight(const QPointF &p) noexcept; |
519 | constexpr inline void setTopRight(const QPointF &p) noexcept; |
520 | constexpr inline void setBottomLeft(const QPointF &p) noexcept; |
521 | |
522 | constexpr inline void moveLeft(qreal pos) noexcept; |
523 | constexpr inline void moveTop(qreal pos) noexcept; |
524 | constexpr inline void moveRight(qreal pos) noexcept; |
525 | constexpr inline void moveBottom(qreal pos) noexcept; |
526 | constexpr inline void moveTopLeft(const QPointF &p) noexcept; |
527 | constexpr inline void moveBottomRight(const QPointF &p) noexcept; |
528 | constexpr inline void moveTopRight(const QPointF &p) noexcept; |
529 | constexpr inline void moveBottomLeft(const QPointF &p) noexcept; |
530 | constexpr inline void moveCenter(const QPointF &p) noexcept; |
531 | |
532 | constexpr inline void translate(qreal dx, qreal dy) noexcept; |
533 | constexpr inline void translate(const QPointF &p) noexcept; |
534 | |
535 | [[nodiscard]] constexpr inline QRectF translated(qreal dx, qreal dy) const noexcept; |
536 | [[nodiscard]] constexpr inline QRectF translated(const QPointF &p) const noexcept; |
537 | |
538 | [[nodiscard]] constexpr inline QRectF transposed() const noexcept; |
539 | |
540 | constexpr inline void moveTo(qreal x, qreal y) noexcept; |
541 | constexpr inline void moveTo(const QPointF &p) noexcept; |
542 | |
543 | constexpr inline void setRect(qreal x, qreal y, qreal w, qreal h) noexcept; |
544 | constexpr inline void getRect(qreal *x, qreal *y, qreal *w, qreal *h) const; |
545 | |
546 | constexpr inline void setCoords(qreal x1, qreal y1, qreal x2, qreal y2) noexcept; |
547 | constexpr inline void getCoords(qreal *x1, qreal *y1, qreal *x2, qreal *y2) const; |
548 | |
549 | constexpr inline void adjust(qreal x1, qreal y1, qreal x2, qreal y2) noexcept; |
550 | [[nodiscard]] constexpr inline QRectF adjusted(qreal x1, qreal y1, qreal x2, qreal y2) const noexcept; |
551 | |
552 | constexpr inline QSizeF size() const noexcept; |
553 | constexpr inline qreal width() const noexcept; |
554 | constexpr inline qreal height() const noexcept; |
555 | constexpr inline void setWidth(qreal w) noexcept; |
556 | constexpr inline void setHeight(qreal h) noexcept; |
557 | constexpr inline void setSize(const QSizeF &s) noexcept; |
558 | |
559 | QRectF operator|(const QRectF &r) const noexcept; |
560 | QRectF operator&(const QRectF &r) const noexcept; |
561 | inline QRectF &operator|=(const QRectF &r) noexcept; |
562 | inline QRectF &operator&=(const QRectF &r) noexcept; |
563 | |
564 | bool contains(const QRectF &r) const noexcept; |
565 | bool contains(const QPointF &p) const noexcept; |
566 | inline bool contains(qreal x, qreal y) const noexcept; |
567 | [[nodiscard]] inline QRectF united(const QRectF &other) const noexcept; |
568 | [[nodiscard]] inline QRectF intersected(const QRectF &other) const noexcept; |
569 | bool intersects(const QRectF &r) const noexcept; |
570 | |
571 | constexpr inline QRectF marginsAdded(const QMarginsF &margins) const noexcept; |
572 | constexpr inline QRectF marginsRemoved(const QMarginsF &margins) const noexcept; |
573 | constexpr inline QRectF &operator+=(const QMarginsF &margins) noexcept; |
574 | constexpr inline QRectF &operator-=(const QMarginsF &margins) noexcept; |
575 | |
576 | private: |
577 | friend constexpr bool comparesEqual(const QRectF &r1, const QRectF &r2) noexcept |
578 | { |
579 | return r1.topLeft() == r2.topLeft() |
580 | && r1.size() == r2.size(); |
581 | } |
582 | Q_DECLARE_EQUALITY_COMPARABLE_LITERAL_TYPE(QRectF) |
583 | |
584 | friend constexpr bool comparesEqual(const QRectF &r1, const QRect &r2) noexcept |
585 | { return r1.topLeft() == r2.topLeft() && r1.size() == r2.size(); } |
586 | Q_DECLARE_EQUALITY_COMPARABLE_LITERAL_TYPE(QRectF, QRect) |
587 | |
588 | friend constexpr bool qFuzzyCompare(const QRectF &lhs, const QRectF &rhs) noexcept |
589 | { |
590 | return qFuzzyCompare(p1: lhs.topLeft(), p2: rhs.topLeft()) |
591 | && qFuzzyCompare(p1: lhs.bottomRight(), p2: rhs.bottomRight()); |
592 | } |
593 | |
594 | friend constexpr bool qFuzzyIsNull(const QRectF &rect) noexcept |
595 | { |
596 | return qFuzzyIsNull(d: rect.w) && qFuzzyIsNull(d: rect.h); |
597 | } |
598 | |
599 | public: |
600 | [[nodiscard]] constexpr inline QRect toRect() const noexcept; |
601 | [[nodiscard]] QRect toAlignedRect() const noexcept; |
602 | |
603 | #if defined(Q_OS_DARWIN) || defined(Q_QDOC) |
604 | [[nodiscard]] static QRectF fromCGRect(CGRect rect) noexcept; |
605 | [[nodiscard]] CGRect toCGRect() const noexcept; |
606 | #endif |
607 | |
608 | #if defined(Q_OS_WASM) || defined(Q_QDOC) |
609 | [[nodiscard]] static QRectF fromDOMRect(emscripten::val domRect); |
610 | [[nodiscard]] emscripten::val toDOMRect() const; |
611 | #endif |
612 | |
613 | private: |
614 | qreal xp; |
615 | qreal yp; |
616 | qreal w; |
617 | qreal h; |
618 | }; |
619 | Q_DECLARE_TYPEINFO(QRectF, Q_RELOCATABLE_TYPE); |
620 | |
621 | |
622 | /***************************************************************************** |
623 | QRectF stream functions |
624 | *****************************************************************************/ |
625 | #ifndef QT_NO_DATASTREAM |
626 | Q_CORE_EXPORT QDataStream &operator<<(QDataStream &, const QRectF &); |
627 | Q_CORE_EXPORT QDataStream &operator>>(QDataStream &, QRectF &); |
628 | #endif |
629 | |
630 | /***************************************************************************** |
631 | QRectF inline member functions |
632 | *****************************************************************************/ |
633 | |
634 | constexpr inline QRectF::QRectF(qreal aleft, qreal atop, qreal awidth, qreal aheight) noexcept |
635 | : xp(aleft), yp(atop), w(awidth), h(aheight) |
636 | { |
637 | } |
638 | |
639 | constexpr inline QRectF::QRectF(const QPointF &atopLeft, const QSizeF &asize) noexcept |
640 | : xp(atopLeft.x()), yp(atopLeft.y()), w(asize.width()), h(asize.height()) |
641 | { |
642 | } |
643 | |
644 | |
645 | constexpr inline QRectF::QRectF(const QPointF &atopLeft, const QPointF &abottomRight) noexcept |
646 | : xp(atopLeft.x()), yp(atopLeft.y()), w(abottomRight.x() - atopLeft.x()), h(abottomRight.y() - atopLeft.y()) |
647 | { |
648 | } |
649 | |
650 | constexpr inline QRectF::QRectF(const QRect &r) noexcept |
651 | : xp(r.x()), yp(r.y()), w(r.width()), h(r.height()) |
652 | { |
653 | } |
654 | |
655 | QT_WARNING_PUSH |
656 | QT_WARNING_DISABLE_FLOAT_COMPARE |
657 | |
658 | constexpr inline bool QRectF::isNull() const noexcept |
659 | { return w == 0. && h == 0.; } |
660 | |
661 | constexpr inline bool QRectF::isEmpty() const noexcept |
662 | { return w <= 0. || h <= 0.; } |
663 | |
664 | QT_WARNING_POP |
665 | |
666 | constexpr inline bool QRectF::isValid() const noexcept |
667 | { return w > 0. && h > 0.; } |
668 | |
669 | constexpr inline qreal QRectF::x() const noexcept |
670 | { return xp; } |
671 | |
672 | constexpr inline qreal QRectF::y() const noexcept |
673 | { return yp; } |
674 | |
675 | constexpr inline void QRectF::setLeft(qreal pos) noexcept |
676 | { qreal diff = pos - xp; xp += diff; w -= diff; } |
677 | |
678 | constexpr inline void QRectF::setRight(qreal pos) noexcept |
679 | { w = pos - xp; } |
680 | |
681 | constexpr inline void QRectF::setTop(qreal pos) noexcept |
682 | { qreal diff = pos - yp; yp += diff; h -= diff; } |
683 | |
684 | constexpr inline void QRectF::setBottom(qreal pos) noexcept |
685 | { h = pos - yp; } |
686 | |
687 | constexpr inline void QRectF::setTopLeft(const QPointF &p) noexcept |
688 | { setLeft(p.x()); setTop(p.y()); } |
689 | |
690 | constexpr inline void QRectF::setTopRight(const QPointF &p) noexcept |
691 | { setRight(p.x()); setTop(p.y()); } |
692 | |
693 | constexpr inline void QRectF::setBottomLeft(const QPointF &p) noexcept |
694 | { setLeft(p.x()); setBottom(p.y()); } |
695 | |
696 | constexpr inline void QRectF::setBottomRight(const QPointF &p) noexcept |
697 | { setRight(p.x()); setBottom(p.y()); } |
698 | |
699 | constexpr inline QPointF QRectF::center() const noexcept |
700 | { return QPointF(xp + w/2, yp + h/2); } |
701 | |
702 | constexpr inline void QRectF::moveLeft(qreal pos) noexcept |
703 | { xp = pos; } |
704 | |
705 | constexpr inline void QRectF::moveTop(qreal pos) noexcept |
706 | { yp = pos; } |
707 | |
708 | constexpr inline void QRectF::moveRight(qreal pos) noexcept |
709 | { xp = pos - w; } |
710 | |
711 | constexpr inline void QRectF::moveBottom(qreal pos) noexcept |
712 | { yp = pos - h; } |
713 | |
714 | constexpr inline void QRectF::moveTopLeft(const QPointF &p) noexcept |
715 | { moveLeft(pos: p.x()); moveTop(pos: p.y()); } |
716 | |
717 | constexpr inline void QRectF::moveTopRight(const QPointF &p) noexcept |
718 | { moveRight(pos: p.x()); moveTop(pos: p.y()); } |
719 | |
720 | constexpr inline void QRectF::moveBottomLeft(const QPointF &p) noexcept |
721 | { moveLeft(pos: p.x()); moveBottom(pos: p.y()); } |
722 | |
723 | constexpr inline void QRectF::moveBottomRight(const QPointF &p) noexcept |
724 | { moveRight(pos: p.x()); moveBottom(pos: p.y()); } |
725 | |
726 | constexpr inline void QRectF::moveCenter(const QPointF &p) noexcept |
727 | { xp = p.x() - w/2; yp = p.y() - h/2; } |
728 | |
729 | constexpr inline qreal QRectF::width() const noexcept |
730 | { return w; } |
731 | |
732 | constexpr inline qreal QRectF::height() const noexcept |
733 | { return h; } |
734 | |
735 | constexpr inline QSizeF QRectF::size() const noexcept |
736 | { return QSizeF(w, h); } |
737 | |
738 | constexpr inline void QRectF::translate(qreal dx, qreal dy) noexcept |
739 | { |
740 | xp += dx; |
741 | yp += dy; |
742 | } |
743 | |
744 | constexpr inline void QRectF::translate(const QPointF &p) noexcept |
745 | { |
746 | xp += p.x(); |
747 | yp += p.y(); |
748 | } |
749 | |
750 | constexpr inline void QRectF::moveTo(qreal ax, qreal ay) noexcept |
751 | { |
752 | xp = ax; |
753 | yp = ay; |
754 | } |
755 | |
756 | constexpr inline void QRectF::moveTo(const QPointF &p) noexcept |
757 | { |
758 | xp = p.x(); |
759 | yp = p.y(); |
760 | } |
761 | |
762 | constexpr inline QRectF QRectF::translated(qreal dx, qreal dy) const noexcept |
763 | { |
764 | return QRectF(xp + dx, yp + dy, w, h); |
765 | } |
766 | |
767 | constexpr inline QRectF QRectF::translated(const QPointF &p) const noexcept |
768 | { return QRectF(xp + p.x(), yp + p.y(), w, h); } |
769 | |
770 | constexpr inline QRectF QRectF::transposed() const noexcept |
771 | { return QRectF(topLeft(), size().transposed()); } |
772 | |
773 | constexpr inline void QRectF::getRect(qreal *ax, qreal *ay, qreal *aaw, qreal *aah) const |
774 | { |
775 | *ax = this->xp; |
776 | *ay = this->yp; |
777 | *aaw = this->w; |
778 | *aah = this->h; |
779 | } |
780 | |
781 | constexpr inline void QRectF::setRect(qreal ax, qreal ay, qreal aaw, qreal aah) noexcept |
782 | { |
783 | this->xp = ax; |
784 | this->yp = ay; |
785 | this->w = aaw; |
786 | this->h = aah; |
787 | } |
788 | |
789 | constexpr inline void QRectF::getCoords(qreal *xp1, qreal *yp1, qreal *xp2, qreal *yp2) const |
790 | { |
791 | *xp1 = xp; |
792 | *yp1 = yp; |
793 | *xp2 = xp + w; |
794 | *yp2 = yp + h; |
795 | } |
796 | |
797 | constexpr inline void QRectF::setCoords(qreal xp1, qreal yp1, qreal xp2, qreal yp2) noexcept |
798 | { |
799 | xp = xp1; |
800 | yp = yp1; |
801 | w = xp2 - xp1; |
802 | h = yp2 - yp1; |
803 | } |
804 | |
805 | constexpr inline void QRectF::adjust(qreal xp1, qreal yp1, qreal xp2, qreal yp2) noexcept |
806 | { |
807 | xp += xp1; |
808 | yp += yp1; |
809 | w += xp2 - xp1; |
810 | h += yp2 - yp1; |
811 | } |
812 | |
813 | constexpr inline QRectF QRectF::adjusted(qreal xp1, qreal yp1, qreal xp2, qreal yp2) const noexcept |
814 | { |
815 | return QRectF(xp + xp1, yp + yp1, w + xp2 - xp1, h + yp2 - yp1); |
816 | } |
817 | |
818 | constexpr inline void QRectF::setWidth(qreal aw) noexcept |
819 | { this->w = aw; } |
820 | |
821 | constexpr inline void QRectF::setHeight(qreal ah) noexcept |
822 | { this->h = ah; } |
823 | |
824 | constexpr inline void QRectF::setSize(const QSizeF &s) noexcept |
825 | { |
826 | w = s.width(); |
827 | h = s.height(); |
828 | } |
829 | |
830 | inline bool QRectF::contains(qreal ax, qreal ay) const noexcept |
831 | { |
832 | return contains(p: QPointF(ax, ay)); |
833 | } |
834 | |
835 | inline QRectF &QRectF::operator|=(const QRectF &r) noexcept |
836 | { |
837 | *this = *this | r; |
838 | return *this; |
839 | } |
840 | |
841 | inline QRectF &QRectF::operator&=(const QRectF &r) noexcept |
842 | { |
843 | *this = *this & r; |
844 | return *this; |
845 | } |
846 | |
847 | inline QRectF QRectF::intersected(const QRectF &r) const noexcept |
848 | { |
849 | return *this & r; |
850 | } |
851 | |
852 | inline QRectF QRectF::united(const QRectF &r) const noexcept |
853 | { |
854 | return *this | r; |
855 | } |
856 | |
857 | constexpr QRectF QRect::toRectF() const noexcept { return *this; } |
858 | |
859 | constexpr inline QRect QRectF::toRect() const noexcept |
860 | { |
861 | // This rounding is designed to minimize the maximum possible difference |
862 | // in topLeft(), bottomRight(), and size() after rounding. |
863 | // All dimensions are at most off by 0.75, and topLeft by at most 0.5. |
864 | const int nxp = qRound(d: xp); |
865 | const int nyp = qRound(d: yp); |
866 | const int nw = qRound(d: w + (xp - nxp) / 2); |
867 | const int nh = qRound(d: h + (yp - nyp) / 2); |
868 | return QRect(nxp, nyp, nw, nh); |
869 | } |
870 | |
871 | constexpr inline QRectF operator+(const QRectF &lhs, const QMarginsF &rhs) noexcept |
872 | { |
873 | return QRectF(QPointF(lhs.left() - rhs.left(), lhs.top() - rhs.top()), |
874 | QSizeF(lhs.width() + rhs.left() + rhs.right(), lhs.height() + rhs.top() + rhs.bottom())); |
875 | } |
876 | |
877 | constexpr inline QRectF operator+(const QMarginsF &lhs, const QRectF &rhs) noexcept |
878 | { |
879 | return QRectF(QPointF(rhs.left() - lhs.left(), rhs.top() - lhs.top()), |
880 | QSizeF(rhs.width() + lhs.left() + lhs.right(), rhs.height() + lhs.top() + lhs.bottom())); |
881 | } |
882 | |
883 | constexpr inline QRectF operator-(const QRectF &lhs, const QMarginsF &rhs) noexcept |
884 | { |
885 | return QRectF(QPointF(lhs.left() + rhs.left(), lhs.top() + rhs.top()), |
886 | QSizeF(lhs.width() - rhs.left() - rhs.right(), lhs.height() - rhs.top() - rhs.bottom())); |
887 | } |
888 | |
889 | constexpr inline QRectF QRectF::marginsAdded(const QMarginsF &margins) const noexcept |
890 | { |
891 | return QRectF(QPointF(xp - margins.left(), yp - margins.top()), |
892 | QSizeF(w + margins.left() + margins.right(), h + margins.top() + margins.bottom())); |
893 | } |
894 | |
895 | constexpr inline QRectF QRectF::marginsRemoved(const QMarginsF &margins) const noexcept |
896 | { |
897 | return QRectF(QPointF(xp + margins.left(), yp + margins.top()), |
898 | QSizeF(w - margins.left() - margins.right(), h - margins.top() - margins.bottom())); |
899 | } |
900 | |
901 | constexpr inline QRectF &QRectF::operator+=(const QMarginsF &margins) noexcept |
902 | { |
903 | *this = marginsAdded(margins); |
904 | return *this; |
905 | } |
906 | |
907 | constexpr inline QRectF &QRectF::operator-=(const QMarginsF &margins) noexcept |
908 | { |
909 | *this = marginsRemoved(margins); |
910 | return *this; |
911 | } |
912 | |
913 | #ifndef QT_NO_DEBUG_STREAM |
914 | Q_CORE_EXPORT QDebug operator<<(QDebug, const QRectF &); |
915 | #endif |
916 | |
917 | QT_END_NAMESPACE |
918 | |
919 | #endif // QRECT_H |
920 |
Definitions
- QRect
- QRect
- comparesEqual
- QRect
- QRect
- QRect
- isNull
- isEmpty
- isValid
- left
- top
- right
- bottom
- x
- y
- setLeft
- setTop
- setRight
- setBottom
- setTopLeft
- setBottomRight
- setTopRight
- setBottomLeft
- setX
- setY
- topLeft
- bottomRight
- topRight
- bottomLeft
- center
- width
- height
- size
- translate
- translate
- translated
- translated
- transposed
- moveTo
- moveTo
- moveLeft
- moveTop
- moveRight
- moveBottom
- moveTopLeft
- moveBottomRight
- moveTopRight
- moveBottomLeft
- moveCenter
- getRect
- setRect
- getCoords
- setCoords
- adjusted
- adjust
- setWidth
- setHeight
- setSize
- contains
- contains
- operator|=
- operator&=
- intersected
- united
- qHash
- operator+
- operator+
- operator-
- marginsAdded
- marginsRemoved
- operator+=
- operator-=
- span
- QRectF
- QRectF
- left
- top
- right
- bottom
- setX
- setY
- topLeft
- bottomRight
- topRight
- bottomLeft
- comparesEqual
- comparesEqual
- qFuzzyCompare
- qFuzzyIsNull
- QRectF
- QRectF
- QRectF
- QRectF
- isNull
- isEmpty
- isValid
- x
- y
- setLeft
- setRight
- setTop
- setBottom
- setTopLeft
- setTopRight
- setBottomLeft
- setBottomRight
- center
- moveLeft
- moveTop
- moveRight
- moveBottom
- moveTopLeft
- moveTopRight
- moveBottomLeft
- moveBottomRight
- moveCenter
- width
- height
- size
- translate
- translate
- moveTo
- moveTo
- translated
- translated
- transposed
- getRect
- setRect
- getCoords
- setCoords
- adjust
- adjusted
- setWidth
- setHeight
- setSize
- contains
- operator|=
- operator&=
- intersected
- united
- toRectF
- toRect
- operator+
- operator+
- operator-
- marginsAdded
- marginsRemoved
- operator+=
Start learning QML with our Intro Training
Find out more