开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 系统编程 > 查看源码
qgraphicsitem.h
资源名称：rootfs-7-9.tar.gz　[点击查看]
上传用户：detong
上传日期：2022-06-22
资源大小：20675k
文件大小：32k
源码类别：

系统编程

开发平台：

Unix_Linux

qgraphicsitem.h：源码内容
  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. ****************************************************************************/
  38. #ifndef QGRAPHICSITEM_H
  39. #define QGRAPHICSITEM_H
  41. #include <QtCore/qglobal.h>
  42. #include <QtCore/qobject.h>
  43. #include <QtCore/qvariant.h>
  44. #include <QtCore/qrect.h>
  45. #include <QtGui/qpainterpath.h>
  46. #include <QtGui/qpixmap.h>
  48. class tst_QGraphicsItem;
  50. QT_BEGIN_HEADER
  52. QT_BEGIN_NAMESPACE
  54. QT_MODULE(Gui)
  56. #if !defined(QT_NO_GRAPHICSVIEW) || (QT_EDITION & QT_MODULE_GRAPHICSVIEW) != QT_MODULE_GRAPHICSVIEW
  58. class QBrush;
  59. class QCursor;
  60. class QFocusEvent;
  61. class QGraphicsItemGroup;
  62. class QGraphicsSceneContextMenuEvent;
  63. class QGraphicsSceneDragDropEvent;
  64. class QGraphicsSceneEvent;
  65. class QGraphicsSceneHoverEvent;
  66. class QGraphicsSceneMouseEvent;
  67. class QGraphicsSceneWheelEvent;
  68. class QGraphicsScene;
  69. class QGraphicsWidget;
  70. class QInputMethodEvent;
  71. class QKeyEvent;
  72. class QMatrix;
  73. class QMenu;
  74. class QPainter;
  75. class QPen;
  76. class QPointF;
  77. class QRectF;
  78. class QStyleOptionGraphicsItem;
  80. class QGraphicsItemPrivate;
  81. class Q_GUI_EXPORT QGraphicsItem
  82. {
  83. public:
  84.     enum GraphicsItemFlag {
  85.         ItemIsMovable = 0x1,
  86.         ItemIsSelectable = 0x2,
  87.         ItemIsFocusable = 0x4,
  88.         ItemClipsToShape = 0x8,
  89.         ItemClipsChildrenToShape = 0x10,
  90.         ItemIgnoresTransformations = 0x20
  91.     };
  92.     Q_DECLARE_FLAGS(GraphicsItemFlags, GraphicsItemFlag)
  94.     enum GraphicsItemChange {
  95.         ItemPositionChange,
  96.         ItemMatrixChange,
  97.         ItemVisibleChange,
  98.         ItemEnabledChange,
  99.         ItemSelectedChange,
  100.         ItemParentChange,
  101.         ItemChildAddedChange,
  102.         ItemChildRemovedChange,
  103.         ItemTransformChange,
  104.         ItemPositionHasChanged,
  105.         ItemTransformHasChanged,
  106.         ItemSceneChange,
  107.         ItemVisibleHasChanged,
  108.         ItemEnabledHasChanged,
  109.         ItemSelectedHasChanged,
  110.         ItemParentHasChanged,
  111.         ItemSceneHasChanged,
  112.         ItemCursorChange,
  113.         ItemCursorHasChanged,
  114.         ItemToolTipChange,
  115.         ItemToolTipHasChanged,
  116.         ItemFlagsChange,
  117.         ItemFlagsHaveChanged,
  118.         ItemZValueChange,
  119.         ItemZValueHasChanged
  120.     };
  122.     enum CacheMode {
  123.         NoCache,
  124.         ItemCoordinateCache,
  125.         DeviceCoordinateCache
  126.     };
  128.     QGraphicsItem(QGraphicsItem *parent = 0
  129. #ifndef Q_QDOC
  130.                   // obsolete argument
  131.                   , QGraphicsScene *scene = 0
  132. #endif
  133.         );
  134.     virtual ~QGraphicsItem();
  136.     QGraphicsScene *scene() const;
  138.     QGraphicsItem *parentItem() const;
  139.     QGraphicsItem *topLevelItem() const;
  140.     QGraphicsWidget *parentWidget() const;
  141.     QGraphicsWidget *topLevelWidget() const;
  142.     QGraphicsWidget *window() const;
  143.     void setParentItem(QGraphicsItem *parent);
  144.     QList<QGraphicsItem *> children() const; // ### obsolete
  145.     QList<QGraphicsItem *> childItems() const;
  146.     bool isWidget() const;
  147.     bool isWindow() const;
  149.     QGraphicsItemGroup *group() const;
  150.     void setGroup(QGraphicsItemGroup *group);
  152.     GraphicsItemFlags flags() const;
  153.     void setFlag(GraphicsItemFlag flag, bool enabled = true);
  154.     void setFlags(GraphicsItemFlags flags);
  156.     CacheMode cacheMode() const;
  157.     void setCacheMode(CacheMode mode, const QSize &cacheSize = QSize());
  159. #ifndef QT_NO_TOOLTIP
  160.     QString toolTip() const;
  161.     void setToolTip(const QString &toolTip);
  162. #endif
  164. #ifndef QT_NO_CURSOR
  165.     QCursor cursor() const;
  166.     void setCursor(const QCursor &cursor);
  167.     bool hasCursor() const;
  168.     void unsetCursor();
  169. #endif
  171.     bool isVisible() const;
  172.     bool isVisibleTo(const QGraphicsItem *parent) const;
  173.     void setVisible(bool visible);
  174.     inline void hide() { setVisible(false); }
  175.     inline void show() { setVisible(true); }
  177.     bool isEnabled() const;
  178.     void setEnabled(bool enabled);
  180.     bool isSelected() const;
  181.     void setSelected(bool selected);
  183.     bool acceptDrops() const;
  184.     void setAcceptDrops(bool on);
  186.     Qt::MouseButtons acceptedMouseButtons() const;
  187.     void setAcceptedMouseButtons(Qt::MouseButtons buttons);
  189.     bool acceptsHoverEvents() const; // obsolete
  190.     void setAcceptsHoverEvents(bool enabled); // obsolete
  191.     bool acceptHoverEvents() const;
  192.     void setAcceptHoverEvents(bool enabled);
  194.     bool handlesChildEvents() const;
  195.     void setHandlesChildEvents(bool enabled);
  197.     bool hasFocus() const;
  198.     void setFocus(Qt::FocusReason focusReason = Qt::OtherFocusReason);
  199.     void clearFocus();
  201.     void grabMouse();
  202.     void ungrabMouse();
  203.     void grabKeyboard();
  204.     void ungrabKeyboard();
  206.     // Positioning in scene coordinates
  207.     QPointF pos() const;
  208.     inline qreal x() const { return pos().x(); }
  209.     inline qreal y() const { return pos().y(); }
  210.     QPointF scenePos() const;
  211.     void setPos(const QPointF &pos);
  212.     inline void setPos(qreal x, qreal y);
  213.     inline void moveBy(qreal dx, qreal dy) { setPos(pos().x() + dx, pos().y() + dy); }
  215.     void ensureVisible(const QRectF &rect = QRectF(), int xmargin = 50, int ymargin = 50);
  216.     inline void ensureVisible(qreal x, qreal y, qreal w, qreal h, int xmargin = 50, int ymargin = 50);
  218.     // Local transformation
  219.     QMatrix matrix() const;
  220.     QMatrix sceneMatrix() const;
  221.     void setMatrix(const QMatrix &matrix, bool combine = false);
  222.     void resetMatrix();
  223.     QTransform transform() const;
  224.     QTransform sceneTransform() const;
  225.     QTransform deviceTransform(const QTransform &viewportTransform) const;
  226.     void setTransform(const QTransform &matrix, bool combine = false);
  227.     void resetTransform();
  228.     
  229.     void rotate(qreal angle);
  230.     void scale(qreal sx, qreal sy);
  231.     void shear(qreal sh, qreal sv);
  232.     void translate(qreal dx, qreal dy);
  233.     virtual void advance(int phase);
  235.     // Stacking order
  236.     qreal zValue() const;
  237.     void setZValue(qreal z);
  239.     // Hit test
  240.     virtual QRectF boundingRect() const = 0;
  241.     QRectF childrenBoundingRect() const;
  242.     QRectF sceneBoundingRect() const;
  243.     virtual QPainterPath shape() const;
  244.     virtual bool contains(const QPointF &point) const;
  245.     virtual bool collidesWithItem(const QGraphicsItem *other, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const;
  246.     virtual bool collidesWithPath(const QPainterPath &path, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const;
  247.     QList<QGraphicsItem *> collidingItems(Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const;
  248.     bool isObscured() const;
  249.     bool isObscured(const QRectF &rect) const; // ### Qt 5: merge with isObscured(), add QRectF arg to isObscuredBy()
  250.     inline bool isObscured(qreal x, qreal y, qreal w, qreal h) const;
  251.     virtual bool isObscuredBy(const QGraphicsItem *item) const;
  252.     virtual QPainterPath opaqueArea() const;
  254.     QRegion boundingRegion(const QTransform &itemToDeviceTransform) const;
  255.     qreal boundingRegionGranularity() const;
  256.     void setBoundingRegionGranularity(qreal granularity);
  258.     // Drawing
  259.     virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = 0) = 0;
  260.     void update(const QRectF &rect = QRectF());
  261.     inline void update(qreal x, qreal y, qreal width, qreal height);
  262.     void scroll(qreal dx, qreal dy, const QRectF &rect = QRectF());
  264.     // Coordinate mapping
  265.     QPointF mapToItem(const QGraphicsItem *item, const QPointF &point) const;
  266.     QPointF mapToParent(const QPointF &point) const;
  267.     QPointF mapToScene(const QPointF &point) const;
  268.     QPolygonF mapToItem(const QGraphicsItem *item, const QRectF &rect) const;
  269.     QPolygonF mapToParent(const QRectF &rect) const;
  270.     QPolygonF mapToScene(const QRectF &rect) const;
  271.     QPolygonF mapToItem(const QGraphicsItem *item, const QPolygonF &polygon) const;
  272.     QPolygonF mapToParent(const QPolygonF &polygon) const;
  273.     QPolygonF mapToScene(const QPolygonF &polygon) const;
  274.     QPainterPath mapToItem(const QGraphicsItem *item, const QPainterPath &path) const;
  275.     QPainterPath mapToParent(const QPainterPath &path) const;
  276.     QPainterPath mapToScene(const QPainterPath &path) const;
  277.     QPointF mapFromItem(const QGraphicsItem *item, const QPointF &point) const;
  278.     QPointF mapFromParent(const QPointF &point) const;
  279.     QPointF mapFromScene(const QPointF &point) const;
  280.     QPolygonF mapFromItem(const QGraphicsItem *item, const QRectF &rect) const;
  281.     QPolygonF mapFromParent(const QRectF &rect) const;
  282.     QPolygonF mapFromScene(const QRectF &rect) const;
  283.     QPolygonF mapFromItem(const QGraphicsItem *item, const QPolygonF &polygon) const;
  284.     QPolygonF mapFromParent(const QPolygonF &polygon) const;
  285.     QPolygonF mapFromScene(const QPolygonF &polygon) const;
  286.     QPainterPath mapFromItem(const QGraphicsItem *item, const QPainterPath &path) const;
  287.     QPainterPath mapFromParent(const QPainterPath &path) const;
  288.     QPainterPath mapFromScene(const QPainterPath &path) const;
  290.     inline QPointF mapToItem(const QGraphicsItem *item, qreal x, qreal y) const;
  291.     inline QPointF mapToParent(qreal x, qreal y) const;
  292.     inline QPointF mapToScene(qreal x, qreal y) const;
  293.     inline QPolygonF mapToItem(const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const;
  294.     inline QPolygonF mapToParent(qreal x, qreal y, qreal w, qreal h) const;
  295.     inline QPolygonF mapToScene(qreal x, qreal y, qreal w, qreal h) const;
  296.     inline QPointF mapFromItem(const QGraphicsItem *item, qreal x, qreal y) const;
  297.     inline QPointF mapFromParent(qreal x, qreal y) const;
  298.     inline QPointF mapFromScene(qreal x, qreal y) const;
  299.     inline QPolygonF mapFromItem(const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const;
  300.     inline QPolygonF mapFromParent(qreal x, qreal y, qreal w, qreal h) const;
  301.     inline QPolygonF mapFromScene(qreal x, qreal y, qreal w, qreal h) const;
  303.     bool isAncestorOf(const QGraphicsItem *child) const;
  304.     QGraphicsItem *commonAncestorItem(const QGraphicsItem *other) const;
  305.     bool isUnderMouse() const;
  307.     // Custom data
  308.     QVariant data(int key) const;
  309.     void setData(int key, const QVariant &value);
  311.     enum {
  312.         Type = 1,
  313.         UserType = 65536
  314.     };
  315.     virtual int type() const;
  317.     void installSceneEventFilter(QGraphicsItem *filterItem);
  318.     void removeSceneEventFilter(QGraphicsItem *filterItem);
  320. protected:
  321.     virtual bool sceneEventFilter(QGraphicsItem *watched, QEvent *event);
  322.     virtual bool sceneEvent(QEvent *event);
  323.     virtual void contextMenuEvent(QGraphicsSceneContextMenuEvent *event);
  324.     virtual void dragEnterEvent(QGraphicsSceneDragDropEvent *event);
  325.     virtual void dragLeaveEvent(QGraphicsSceneDragDropEvent *event);
  326.     virtual void dragMoveEvent(QGraphicsSceneDragDropEvent *event);
  327.     virtual void dropEvent(QGraphicsSceneDragDropEvent *event);
  328.     virtual void focusInEvent(QFocusEvent *event);
  329.     virtual void focusOutEvent(QFocusEvent *event);
  330.     virtual void hoverEnterEvent(QGraphicsSceneHoverEvent *event);
  331.     virtual void hoverMoveEvent(QGraphicsSceneHoverEvent *event);
  332.     virtual void hoverLeaveEvent(QGraphicsSceneHoverEvent *event);
  333.     virtual void keyPressEvent(QKeyEvent *event);
  334.     virtual void keyReleaseEvent(QKeyEvent *event);
  335.     virtual void mousePressEvent(QGraphicsSceneMouseEvent *event);
  336.     virtual void mouseMoveEvent(QGraphicsSceneMouseEvent *event);
  337.     virtual void mouseReleaseEvent(QGraphicsSceneMouseEvent *event);
  338.     virtual void mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event);
  339.     virtual void wheelEvent(QGraphicsSceneWheelEvent *event);
  340.     virtual void inputMethodEvent(QInputMethodEvent *event);
  341.     virtual QVariant inputMethodQuery(Qt::InputMethodQuery query) const;
  343.     virtual QVariant itemChange(GraphicsItemChange change, const QVariant &value);
  345.     enum Extension {
  346.         UserExtension = 0x80000000
  347.     };
  348.     virtual bool supportsExtension(Extension extension) const;
  349.     virtual void setExtension(Extension extension, const QVariant &variant);
  350.     virtual QVariant extension(const QVariant &variant) const;
  352. protected:
  353.     QGraphicsItem(QGraphicsItemPrivate &dd,
  354.                   QGraphicsItem *parent, QGraphicsScene *scene);
  355.     QGraphicsItemPrivate *d_ptr;
  357.     void addToIndex();
  358.     void removeFromIndex();
  359.     void prepareGeometryChange();
  361. private:
  362.     Q_DISABLE_COPY(QGraphicsItem)
  363.     Q_DECLARE_PRIVATE(QGraphicsItem)
  364.     friend class QGraphicsItemGroup;
  365.     friend class QGraphicsScene;
  366.     friend class QGraphicsScenePrivate;
  367.     friend class QGraphicsSceneFindItemBspTreeVisitor;
  368.     friend class QGraphicsView;
  369.     friend class QGraphicsViewPrivate;
  370.     friend class QGraphicsWidget;
  371.     friend class ::tst_QGraphicsItem;
  372.     friend bool qt_closestLeaf(const QGraphicsItem *, const QGraphicsItem *);
  373.     friend bool qt_closestItemFirst(const QGraphicsItem *, const QGraphicsItem *);
  374. };
  376. Q_DECLARE_OPERATORS_FOR_FLAGS(QGraphicsItem::GraphicsItemFlags)
  377. inline void QGraphicsItem::setPos(qreal ax, qreal ay)
  378. { setPos(QPointF(ax, ay)); }
  379. inline void QGraphicsItem::ensureVisible(qreal ax, qreal ay, qreal w, qreal h, int xmargin, int ymargin)
  380. { ensureVisible(QRectF(ax, ay, w, h), xmargin, ymargin); }
  381. inline void QGraphicsItem::update(qreal ax, qreal ay, qreal width, qreal height)
  382. { update(QRectF(ax, ay, width, height)); }
  383. inline bool QGraphicsItem::isObscured(qreal ax, qreal ay, qreal w, qreal h) const
  384. { return isObscured(QRectF(ax, ay, w, h)); }
  385. inline QPointF QGraphicsItem::mapToItem(const QGraphicsItem *item, qreal ax, qreal ay) const
  386. { return mapToItem(item, QPointF(ax, ay)); }
  387. inline QPointF QGraphicsItem::mapToParent(qreal ax, qreal ay) const
  388. { return mapToParent(QPointF(ax, ay)); }
  389. inline QPointF QGraphicsItem::mapToScene(qreal ax, qreal ay) const
  390. { return mapToScene(QPointF(ax, ay));  }
  391. inline QPointF QGraphicsItem::mapFromItem(const QGraphicsItem *item, qreal ax, qreal ay) const
  392. { return mapFromItem(item, QPointF(ax, ay)); }
  393. inline QPointF QGraphicsItem::mapFromParent(qreal ax, qreal ay) const
  394. { return mapFromParent(QPointF(ax, ay));  }
  395. inline QPointF QGraphicsItem::mapFromScene(qreal ax, qreal ay) const
  396. { return mapFromScene(QPointF(ax, ay));  }
  397. inline QPolygonF QGraphicsItem::mapToItem(const QGraphicsItem *item, qreal ax, qreal ay, qreal w, qreal h) const
  398. { return mapToItem(item, QRectF(ax, ay, w, h)); }
  399. inline QPolygonF QGraphicsItem::mapToParent(qreal ax, qreal ay, qreal w, qreal h) const
  400. { return mapToParent(QRectF(ax, ay, w, h)); }
  401. inline QPolygonF QGraphicsItem::mapToScene(qreal ax, qreal ay, qreal w, qreal h) const
  402. { return mapToScene(QRectF(ax, ay, w, h)); }
  403. inline QPolygonF QGraphicsItem::mapFromItem(const QGraphicsItem *item, qreal ax, qreal ay, qreal w, qreal h) const
  404. { return mapFromItem(item, QRectF(ax, ay, w, h)); }
  405. inline QPolygonF QGraphicsItem::mapFromParent(qreal ax, qreal ay, qreal w, qreal h) const
  406. { return mapFromParent(QRectF(ax, ay, w, h)); }
  407. inline QPolygonF QGraphicsItem::mapFromScene(qreal ax, qreal ay, qreal w, qreal h) const
  408. { return mapFromScene(QRectF(ax, ay, w, h)); }
  410. class QAbstractGraphicsShapeItemPrivate;
  411. class Q_GUI_EXPORT QAbstractGraphicsShapeItem : public QGraphicsItem
  412. {
  413. public:
  414.     QAbstractGraphicsShapeItem(QGraphicsItem *parent = 0
  415. #ifndef Q_QDOC
  416.                                // obsolete argument
  417.                                , QGraphicsScene *scene = 0
  418. #endif
  419.         );
  420.     ~QAbstractGraphicsShapeItem();
  422.     QPen pen() const;
  423.     void setPen(const QPen &pen);
  425.     QBrush brush() const;
  426.     void setBrush(const QBrush &brush);
  428.     bool isObscuredBy(const QGraphicsItem *item) const;
  429.     QPainterPath opaqueArea() const;
  431. protected:
  432.     QAbstractGraphicsShapeItem(QAbstractGraphicsShapeItemPrivate &dd,
  433.                                QGraphicsItem *parent, QGraphicsScene *scene);
  435. private:
  436.     Q_DISABLE_COPY(QAbstractGraphicsShapeItem)
  437.     Q_DECLARE_PRIVATE(QAbstractGraphicsShapeItem)
  438. };
  440. class QGraphicsPathItemPrivate;
  441. class Q_GUI_EXPORT QGraphicsPathItem : public QAbstractGraphicsShapeItem
  442. {
  443. public:
  444.     QGraphicsPathItem(QGraphicsItem *parent = 0
  445. #ifndef Q_QDOC
  446.                       // obsolete argument
  447.                       , QGraphicsScene *scene = 0
  448. #endif
  449.         );
  450.     QGraphicsPathItem(const QPainterPath &path, QGraphicsItem *parent = 0
  451. #ifndef Q_QDOC
  452.                       // obsolete argument
  453.                       , QGraphicsScene *scene = 0
  454. #endif
  455.         );
  456.     ~QGraphicsPathItem();
  458.     QPainterPath path() const;
  459.     void setPath(const QPainterPath &path);
  461.     QRectF boundingRect() const;
  462.     QPainterPath shape() const;
  463.     bool contains(const QPointF &point) const;
  465.     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = 0);
  467.     bool isObscuredBy(const QGraphicsItem *item) const;
  468.     QPainterPath opaqueArea() const;
  470.     enum { Type = 2 };
  471.     int type() const;
  473. protected:
  474.     bool supportsExtension(Extension extension) const;
  475.     void setExtension(Extension extension, const QVariant &variant);
  476.     QVariant extension(const QVariant &variant) const;
  478. private:
  479.     Q_DISABLE_COPY(QGraphicsPathItem)
  480.     Q_DECLARE_PRIVATE(QGraphicsPathItem)
  481. };
  483. class QGraphicsRectItemPrivate;
  484. class Q_GUI_EXPORT QGraphicsRectItem : public QAbstractGraphicsShapeItem
  485. {
  486. public:
  487.     QGraphicsRectItem(QGraphicsItem *parent = 0
  488. #ifndef Q_QDOC
  489.                       // obsolete argument
  490.                       , QGraphicsScene *scene = 0
  491. #endif
  492.         );
  493.     QGraphicsRectItem(const QRectF &rect, QGraphicsItem *parent = 0
  494. #ifndef Q_QDOC
  495.                       // obsolete argument
  496.                       , QGraphicsScene *scene = 0
  497. #endif
  498.         );
  499.     QGraphicsRectItem(qreal x, qreal y, qreal w, qreal h, QGraphicsItem *parent = 0
  500. #ifndef Q_QDOC
  501.                       // obsolete argument
  502.                       , QGraphicsScene *scene = 0
  503. #endif
  504.         );
  505.     ~QGraphicsRectItem();
  507.     QRectF rect() const;
  508.     void setRect(const QRectF &rect);
  509.     inline void setRect(qreal x, qreal y, qreal w, qreal h);
  511.     QRectF boundingRect() const;
  512.     QPainterPath shape() const;
  513.     bool contains(const QPointF &point) const;
  515.     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = 0);
  517.     bool isObscuredBy(const QGraphicsItem *item) const;
  518.     QPainterPath opaqueArea() const;
  520.     enum { Type = 3 };
  521.     int type() const;
  523. protected:
  524.     bool supportsExtension(Extension extension) const;
  525.     void setExtension(Extension extension, const QVariant &variant);
  526.     QVariant extension(const QVariant &variant) const;
  528. private:
  529.     Q_DISABLE_COPY(QGraphicsRectItem)
  530.     Q_DECLARE_PRIVATE(QGraphicsRectItem)
  531. };
  533. inline void QGraphicsRectItem::setRect(qreal ax, qreal ay, qreal w, qreal h)
  534. { setRect(QRectF(ax, ay, w, h)); }
  536. class QGraphicsEllipseItemPrivate;
  537. class Q_GUI_EXPORT QGraphicsEllipseItem : public QAbstractGraphicsShapeItem
  538. {
  539. public:
  540.     QGraphicsEllipseItem(QGraphicsItem *parent = 0
  541. #ifndef Q_QDOC
  542.                          // obsolete argument
  543.                          , QGraphicsScene *scene = 0
  544. #endif
  545.         );
  546.     QGraphicsEllipseItem(const QRectF &rect, QGraphicsItem *parent = 0
  547. #ifndef Q_QDOC
  548.                          // obsolete argument
  549.                          , QGraphicsScene *scene = 0
  550. #endif
  551.         );
  552.     QGraphicsEllipseItem(qreal x, qreal y, qreal w, qreal h, QGraphicsItem *parent = 0
  553. #ifndef Q_QDOC
  554.                          // obsolete argument
  555.                          , QGraphicsScene *scene = 0
  556. #endif
  557.         );
  558.     ~QGraphicsEllipseItem();
  560.     QRectF rect() const;
  561.     void setRect(const QRectF &rect);
  562.     inline void setRect(qreal x, qreal y, qreal w, qreal h);
  564.     int startAngle() const;
  565.     void setStartAngle(int angle);
  567.     int spanAngle() const;
  568.     void setSpanAngle(int angle);
  570.     QRectF boundingRect() const;
  571.     QPainterPath shape() const;
  572.     bool contains(const QPointF &point) const;
  574.     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = 0);
  576.     bool isObscuredBy(const QGraphicsItem *item) const;
  577.     QPainterPath opaqueArea() const;
  579.     enum { Type = 4 };
  580.     int type() const;
  582. protected:
  583.     bool supportsExtension(Extension extension) const;
  584.     void setExtension(Extension extension, const QVariant &variant);
  585.     QVariant extension(const QVariant &variant) const;
  587. private:
  588.     Q_DISABLE_COPY(QGraphicsEllipseItem)
  589.     Q_DECLARE_PRIVATE(QGraphicsEllipseItem)
  590. };
  592. inline void QGraphicsEllipseItem::setRect(qreal ax, qreal ay, qreal w, qreal h)
  593. { setRect(QRectF(ax, ay, w, h)); }
  595. class QGraphicsPolygonItemPrivate;
  596. class Q_GUI_EXPORT QGraphicsPolygonItem : public QAbstractGraphicsShapeItem
  597. {
  598. public:
  599.     QGraphicsPolygonItem(QGraphicsItem *parent = 0
  600. #ifndef Q_QDOC
  601.                          // obsolete argument
  602.                          , QGraphicsScene *scene = 0
  603. #endif
  604.         );
  605.     QGraphicsPolygonItem(const QPolygonF &polygon,
  606.                          QGraphicsItem *parent = 0
  607. #ifndef Q_QDOC
  608.                          // obsolete argument
  609.                          , QGraphicsScene *scene = 0
  610. #endif
  611.         );
  612.     ~QGraphicsPolygonItem();
  614.     QPolygonF polygon() const;
  615.     void setPolygon(const QPolygonF &polygon);
  617.     Qt::FillRule fillRule() const;
  618.     void setFillRule(Qt::FillRule rule);
  620.     QRectF boundingRect() const;
  621.     QPainterPath shape() const;
  622.     bool contains(const QPointF &point) const;
  624.     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = 0);
  626.     bool isObscuredBy(const QGraphicsItem *item) const;
  627.     QPainterPath opaqueArea() const;
  629.     enum { Type = 5 };
  630.     int type() const;
  632. protected:
  633.     bool supportsExtension(Extension extension) const;
  634.     void setExtension(Extension extension, const QVariant &variant);
  635.     QVariant extension(const QVariant &variant) const;
  637. private:
  638.     Q_DISABLE_COPY(QGraphicsPolygonItem)
  639.     Q_DECLARE_PRIVATE(QGraphicsPolygonItem)
  640. };
  642. class QGraphicsLineItemPrivate;
  643. class Q_GUI_EXPORT QGraphicsLineItem : public QGraphicsItem
  644. {
  645. public:
  646.     QGraphicsLineItem(QGraphicsItem *parent = 0
  647. #ifndef Q_QDOC
  648.                       // obsolete argument
  649.                       , QGraphicsScene *scene = 0
  650. #endif
  651.         );
  652.     QGraphicsLineItem(const QLineF &line, QGraphicsItem *parent = 0
  653. #ifndef Q_QDOC
  654.                       // obsolete argument
  655.                       , QGraphicsScene *scene = 0
  656. #endif
  657.         );
  658.     QGraphicsLineItem(qreal x1, qreal y1, qreal x2, qreal y2, QGraphicsItem *parent = 0
  659. #ifndef Q_QDOC
  660.                       // obsolete argument
  661.                       , QGraphicsScene *scene = 0
  662. #endif
  663.         );
  664.     ~QGraphicsLineItem();
  666.     QPen pen() const;
  667.     void setPen(const QPen &pen);
  669.     QLineF line() const;
  670.     void setLine(const QLineF &line);
  671.     inline void setLine(qreal x1, qreal y1, qreal x2, qreal y2)
  672.     { setLine(QLineF(x1, y1, x2, y2)); }
  674.     QRectF boundingRect() const;
  675.     QPainterPath shape() const;
  676.     bool contains(const QPointF &point) const;
  678.     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = 0);
  680.     bool isObscuredBy(const QGraphicsItem *item) const;
  681.     QPainterPath opaqueArea() const;
  683.     enum { Type = 6 };
  684.     int type() const;
  686. protected:
  687.     bool supportsExtension(Extension extension) const;
  688.     void setExtension(Extension extension, const QVariant &variant);
  689.     QVariant extension(const QVariant &variant) const;
  691. private:
  692.     Q_DISABLE_COPY(QGraphicsLineItem)
  693.     Q_DECLARE_PRIVATE(QGraphicsLineItem)
  694. };
  696. class QGraphicsPixmapItemPrivate;
  697. class Q_GUI_EXPORT QGraphicsPixmapItem : public QGraphicsItem
  698. {
  699. public:
  700.     enum ShapeMode {
  701.         MaskShape,
  702.         BoundingRectShape,
  703.         HeuristicMaskShape
  704.     };
  706.     QGraphicsPixmapItem(QGraphicsItem *parent = 0
  707. #ifndef Q_QDOC
  708.                         // obsolete argument
  709.                         , QGraphicsScene *scene = 0
  710. #endif
  711.         );
  712.     QGraphicsPixmapItem(const QPixmap &pixmap, QGraphicsItem *parent = 0
  713. #ifndef Q_QDOC
  714.                         // obsolete argument
  715.                         , QGraphicsScene *scene = 0
  716. #endif
  717.         );
  718.     ~QGraphicsPixmapItem();
  720.     QPixmap pixmap() const;
  721.     void setPixmap(const QPixmap &pixmap);
  723.     Qt::TransformationMode transformationMode() const;
  724.     void setTransformationMode(Qt::TransformationMode mode);
  726.     QPointF offset() const;
  727.     void setOffset(const QPointF &offset);
  728.     inline void setOffset(qreal x, qreal y);
  730.     QRectF boundingRect() const;
  731.     QPainterPath shape() const;
  732.     bool contains(const QPointF &point) const;
  734.     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget);
  736.     bool isObscuredBy(const QGraphicsItem *item) const;
  737.     QPainterPath opaqueArea() const;
  739.     enum { Type = 7 };
  740.     int type() const;
  742.     ShapeMode shapeMode() const;
  743.     void setShapeMode(ShapeMode mode);
  745. protected:
  746.     bool supportsExtension(Extension extension) const;
  747.     void setExtension(Extension extension, const QVariant &variant);
  748.     QVariant extension(const QVariant &variant) const;
  750. private:
  751.     Q_DISABLE_COPY(QGraphicsPixmapItem)
  752.     Q_DECLARE_PRIVATE(QGraphicsPixmapItem)
  753. };
  755. inline void QGraphicsPixmapItem::setOffset(qreal ax, qreal ay)
  756. { setOffset(QPointF(ax, ay)); }
  758. class QGraphicsTextItemPrivate;
  759. class QTextDocument;
  760. class QTextCursor;
  761. class Q_GUI_EXPORT QGraphicsTextItem : public QObject, public QGraphicsItem
  762. {
  763.     Q_OBJECT
  764.     QDOC_PROPERTY(bool openExternalLinks READ openExternalLinks WRITE setOpenExternalLinks)
  765.     QDOC_PROPERTY(QTextCursor textCursor READ textCursor WRITE setTextCursor)
  767. public:
  768.     QGraphicsTextItem(QGraphicsItem *parent = 0
  769. #ifndef Q_QDOC
  770.                       // obsolete argument
  771.                       , QGraphicsScene *scene = 0
  772. #endif
  773.         );
  774.     QGraphicsTextItem(const QString &text, QGraphicsItem *parent = 0
  775. #ifndef Q_QDOC
  776.                       // obsolete argument
  777.                       , QGraphicsScene *scene = 0
  778. #endif
  779.         );
  780.     ~QGraphicsTextItem();
  782.     QString toHtml() const;
  783.     void setHtml(const QString &html);
  785.     QString toPlainText() const;
  786.     void setPlainText(const QString &text);
  788.     QFont font() const;
  789.     void setFont(const QFont &font);
  791.     void setDefaultTextColor(const QColor &c);
  792.     QColor defaultTextColor() const;
  794.     QRectF boundingRect() const;
  795.     QPainterPath shape() const;
  796.     bool contains(const QPointF &point) const;
  798.     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget);
  800.     bool isObscuredBy(const QGraphicsItem *item) const;
  801.     QPainterPath opaqueArea() const;
  803.     enum { Type = 8 };
  804.     int type() const;
  806.     void setTextWidth(qreal width);
  807.     qreal textWidth() const;
  809.     void adjustSize();
  811.     void setDocument(QTextDocument *document);
  812.     QTextDocument *document() const;
  814.     void setTextInteractionFlags(Qt::TextInteractionFlags flags);
  815.     Qt::TextInteractionFlags textInteractionFlags() const;
  817.     void setOpenExternalLinks(bool open);
  818.     bool openExternalLinks() const;
  820.     void setTextCursor(const QTextCursor &cursor);
  821.     QTextCursor textCursor() const;
  823. Q_SIGNALS:
  824.     void linkActivated(const QString &);
  825.     void linkHovered(const QString &);
  827. protected:
  828.     bool sceneEvent(QEvent *event);
  829.     void mousePressEvent(QGraphicsSceneMouseEvent *event);
  830.     void mouseMoveEvent(QGraphicsSceneMouseEvent *event);
  831.     void mouseReleaseEvent(QGraphicsSceneMouseEvent *event);
  832.     void mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event);
  833.     void contextMenuEvent(QGraphicsSceneContextMenuEvent *event);
  834.     void keyPressEvent(QKeyEvent *event);
  835.     void keyReleaseEvent(QKeyEvent *event);
  836.     void focusInEvent(QFocusEvent *event);
  837.     void focusOutEvent(QFocusEvent *event);
  838.     void dragEnterEvent(QGraphicsSceneDragDropEvent *event);
  839.     void dragLeaveEvent(QGraphicsSceneDragDropEvent *event);
  840.     void dragMoveEvent(QGraphicsSceneDragDropEvent *event);
  841.     void dropEvent(QGraphicsSceneDragDropEvent *event);
  842.     void inputMethodEvent(QInputMethodEvent *event);
  843.     void hoverEnterEvent(QGraphicsSceneHoverEvent *event);
  844.     void hoverMoveEvent(QGraphicsSceneHoverEvent *event);
  845.     void hoverLeaveEvent(QGraphicsSceneHoverEvent *event);
  847.     QVariant inputMethodQuery(Qt::InputMethodQuery query) const;
  849.     bool supportsExtension(Extension extension) const;
  850.     void setExtension(Extension extension, const QVariant &variant);
  851.     QVariant extension(const QVariant &variant) const;
  853. private:
  854.     Q_DISABLE_COPY(QGraphicsTextItem)
  855.     Q_PRIVATE_SLOT(dd, void _q_updateBoundingRect(const QSizeF &))
  856.     Q_PRIVATE_SLOT(dd, void _q_update(QRectF))
  857.     Q_PRIVATE_SLOT(dd, void _q_ensureVisible(QRectF))
  858.     QGraphicsTextItemPrivate *dd;
  859.     friend class QGraphicsTextItemPrivate;
  860. };
  862. class QGraphicsSimpleTextItemPrivate;
  863. class Q_GUI_EXPORT QGraphicsSimpleTextItem : public QAbstractGraphicsShapeItem
  864. {
  865. public:
  866.     QGraphicsSimpleTextItem(QGraphicsItem *parent = 0
  867. #ifndef Q_QDOC
  868.                             // obsolete argument
  869.                             , QGraphicsScene *scene = 0
  870. #endif
  871.         );
  872.     QGraphicsSimpleTextItem(const QString &text, QGraphicsItem *parent = 0
  873. #ifndef Q_QDOC
  874.                             // obsolete argument
  875.                             , QGraphicsScene *scene = 0
  876. #endif
  877.         );
  878.     ~QGraphicsSimpleTextItem();
  880.     void setText(const QString &text);
  881.     QString text() const;
  883.     void setFont(const QFont &font);
  884.     QFont font() const;
  886.     QRectF boundingRect() const;
  887.     QPainterPath shape() const;
  888.     bool contains(const QPointF &point) const;
  890.     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget);
  892.     bool isObscuredBy(const QGraphicsItem *item) const;
  893.     QPainterPath opaqueArea() const;
  895.     enum { Type = 9 };
  896.     int type() const;
  898. protected:
  899.     bool supportsExtension(Extension extension) const;
  900.     void setExtension(Extension extension, const QVariant &variant);
  901.     QVariant extension(const QVariant &variant) const;
  903. private:
  904.     Q_DISABLE_COPY(QGraphicsSimpleTextItem)
  905.     Q_DECLARE_PRIVATE(QGraphicsSimpleTextItem)
  906. };
  908. class QGraphicsItemGroupPrivate;
  909. class Q_GUI_EXPORT QGraphicsItemGroup : public QGraphicsItem
  910. {
  911. public:
  912.     QGraphicsItemGroup(QGraphicsItem *parent = 0
  913. #ifndef Q_QDOC
  914.                        // obsolete argument
  915.                        , QGraphicsScene *scene = 0
  916. #endif
  917.         );
  918.     ~QGraphicsItemGroup();
  920.     void addToGroup(QGraphicsItem *item);
  921.     void removeFromGroup(QGraphicsItem *item);
  923.     QRectF boundingRect() const;
  924.     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = 0);
  926.     bool isObscuredBy(const QGraphicsItem *item) const;
  927.     QPainterPath opaqueArea() const;
  929.     enum { Type = 10 };
  930.     int type() const;
  932. private:
  933.     Q_DISABLE_COPY(QGraphicsItemGroup)
  934.     Q_DECLARE_PRIVATE(QGraphicsItemGroup)
  935. };
  937. template <class T> inline T qgraphicsitem_cast(QGraphicsItem *item)
  938. {
  939.     return int(static_cast<T>(0)->Type) == int(QGraphicsItem::Type)
  940.         || (item && int(static_cast<T>(0)->Type) == item->type()) ? static_cast<T>(item) : 0;
  941. }
  943. template <class T> inline T qgraphicsitem_cast(const QGraphicsItem *item)
  944. {
  945.     return int(static_cast<T>(0)->Type) == int(QGraphicsItem::Type)
  946.         || (item && int(static_cast<T>(0)->Type) == item->type()) ? static_cast<T>(item) : 0;
  947. }
  949. #ifndef QT_NO_DEBUG_STREAM
  950. Q_GUI_EXPORT QDebug operator<<(QDebug debug, QGraphicsItem *item);
  951. Q_GUI_EXPORT QDebug operator<<(QDebug debug, QGraphicsItem::GraphicsItemChange change);
  952. #endif
  954. QT_END_NAMESPACE
  956. Q_DECLARE_METATYPE(QGraphicsItem *)
  957. Q_DECLARE_METATYPE(QGraphicsScene *)
  959. QT_END_HEADER
  961. #endif
  963. #endif // QT_NO_GRAPHICSVIEW