qregion.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:7k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 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. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QREGION_H
  38. #define QREGION_H
  39. #include <QtCore/qatomic.h>
  40. #include <QtCore/qrect.h>
  41. #include <QtGui/qwindowdefs.h>
  42. QT_BEGIN_HEADER
  43. QT_BEGIN_NAMESPACE
  44. QT_MODULE(Gui)
  45. template <class T> class QVector;
  46. class QVariant;
  47. #if defined(Q_WS_QWS) || defined(Q_WS_X11) || defined(Q_WS_MAC) || defined(Q_OS_WINCE)
  48. struct QRegionPrivate;
  49. #endif
  50. class QBitmap;
  51. class Q_GUI_EXPORT QRegion
  52. {
  53. public:
  54.     enum RegionType { Rectangle, Ellipse };
  55.     QRegion();
  56.     QRegion(int x, int y, int w, int h, RegionType t = Rectangle);
  57.     QRegion(const QRect &r, RegionType t = Rectangle);
  58.     QRegion(const QPolygon &pa, Qt::FillRule fillRule = Qt::OddEvenFill);
  59. #ifdef QT3_SUPPORT
  60.     QT3_SUPPORT_CONSTRUCTOR QRegion(const QPolygon &pa, bool winding);
  61. #endif
  62.     QRegion(const QRegion &region);
  63.     QRegion(const QBitmap &bitmap);
  64.     ~QRegion();
  65.     QRegion &operator=(const QRegion &);
  66. #ifdef QT3_SUPPORT
  67.     inline QT3_SUPPORT bool isNull() const { return isEmpty(); }
  68. #endif
  69.     bool isEmpty() const;
  70.     bool contains(const QPoint &p) const;
  71.     bool contains(const QRect &r) const;
  72.     void translate(int dx, int dy);
  73.     inline void translate(const QPoint &p) { translate(p.x(), p.y()); }
  74.     QRegion translated(int dx, int dy) const;
  75.     inline QRegion translated(const QPoint &p) const { return translated(p.x(), p.y()); }
  76.     // ### Qt 5: make these four functions QT4_SUPPORT
  77.     QRegion unite(const QRegion &r) const;
  78.     QRegion unite(const QRect &r) const;
  79.     QRegion intersect(const QRegion &r) const;
  80.     QRegion intersect(const QRect &r) const;
  81.     QRegion subtract(const QRegion &r) const;
  82.     QRegion eor(const QRegion &r) const;
  83.     inline QRegion united(const QRegion &r) const { return unite(r); }
  84.     inline QRegion united(const QRect &r) const { return unite(r); }
  85.     inline QRegion intersected(const QRegion &r) const { return intersect(r); }
  86.     inline QRegion intersected(const QRect &r) const { return intersect(r); }
  87.     inline QRegion subtracted(const QRegion &r) const { return subtract(r); }
  88.     inline QRegion xored(const QRegion &r) const { return eor(r); }
  89.     bool intersects(const QRegion &r) const;
  90.     bool intersects(const QRect &r) const;
  91.     QRect boundingRect() const;
  92.     QVector<QRect> rects() const;
  93.     void setRects(const QRect *rect, int num);
  94.     int numRects() const;
  95.     const QRegion operator|(const QRegion &r) const;
  96.     const QRegion operator+(const QRegion &r) const;
  97.     const QRegion operator+(const QRect &r) const;
  98.     const QRegion operator&(const QRegion &r) const;
  99.     const QRegion operator&(const QRect &r) const;
  100.     const QRegion operator-(const QRegion &r) const;
  101.     const QRegion operator^(const QRegion &r) const;
  102.     QRegion& operator|=(const QRegion &r);
  103.     QRegion& operator+=(const QRegion &r);
  104.     QRegion& operator+=(const QRect &r);
  105.     QRegion& operator&=(const QRegion &r);
  106.     QRegion& operator&=(const QRect &r);
  107.     QRegion& operator-=(const QRegion &r);
  108.     QRegion& operator^=(const QRegion &r);
  109.     bool operator==(const QRegion &r) const;
  110.     inline bool operator!=(const QRegion &r) const { return !(operator==(r)); }
  111.     operator QVariant() const;
  112. #ifdef qdoc
  113.     Handle handle() const;
  114. #endif
  115. #ifndef qdoc
  116. #if defined(Q_WS_WIN)
  117.     inline HRGN    handle() const { ensureHandle(); return d->rgn; }
  118. #elif defined(Q_WS_X11)
  119.     inline Region handle() const { if(!d->rgn) updateX11Region(); return d->rgn; }
  120. #elif defined(Q_WS_MAC)
  121.     inline RgnHandle handle() const { return handle(false); }
  122.     RgnHandle handle(bool require_rgn) const;
  123. #elif defined(Q_WS_QWS)
  124.     inline void *handle() const { return d->qt_rgn; }
  125. #endif
  126. #endif
  127. #ifndef QT_NO_DATASTREAM
  128.     friend Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QRegion &);
  129.     friend Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QRegion &);
  130. #endif
  131. private:
  132.     QRegion copy() const;   // helper of detach.
  133.     void detach();
  134. #if defined(Q_WS_WIN)
  135.     void ensureHandle() const;
  136.     QRegion winCombine(const QRegion &r, int num) const;
  137. #elif defined(Q_WS_X11)
  138.     void updateX11Region() const;
  139.     void *clipRectangles(int &num) const;
  140.     friend void *qt_getClipRects(const QRegion &r, int &num);
  141. #elif defined(Q_WS_MAC)
  142.     friend QRegion qt_mac_convert_mac_region(RgnHandle rgn);
  143. #endif
  144.     friend bool qt_region_strictContains(const QRegion &region,
  145.                                          const QRect &rect);
  146.     friend struct QRegionPrivate;
  147.     void exec(const QByteArray &ba, int ver = 0);
  148.     struct QRegionData {
  149.         QBasicAtomicInt ref;
  150. #if defined(Q_WS_WIN)
  151.         HRGN   rgn;
  152. #elif defined(Q_WS_X11)
  153.         Region rgn;
  154.         void *xrectangles;
  155. #elif defined(Q_WS_MAC)
  156.         mutable RgnHandle rgn;
  157. #endif
  158. #if defined(Q_WS_QWS) || defined(Q_WS_X11) || defined(Q_WS_MAC) || defined(Q_OS_WINCE)
  159.         QRegionPrivate *qt_rgn;
  160. #endif
  161.     };
  162. #if defined(Q_WS_WIN)
  163.     friend class QETWidget;
  164. #endif
  165.     struct QRegionData *d;
  166.     static struct QRegionData shared_empty;
  167.     static void cleanUp(QRegionData *x);
  168. };
  169. /*****************************************************************************
  170.   QRegion stream functions
  171.  *****************************************************************************/
  172. #ifndef QT_NO_DATASTREAM
  173. Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QRegion &);
  174. Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QRegion &);
  175. #endif
  176. #ifndef QT_NO_DEBUG_STREAM
  177. Q_GUI_EXPORT QDebug operator<<(QDebug, const QRegion &);
  178. #endif
  179. QT_END_NAMESPACE
  180. QT_END_HEADER
  181. #endif // QREGION_H