Qt 4.8
|
The QGraphicsItemGroup class provides a container that treats a group of items as a single item. More...
#include <qgraphicsitem.h>
Public Functions | |
void | addToGroup (QGraphicsItem *item) |
Adds the given item and item's child items to this item group. More... | |
QRectF | boundingRect () const |
Returns the bounding rect of this group item, and all its children. More... | |
bool | isObscuredBy (const QGraphicsItem *item) const |
Reimplemented Function More... | |
QPainterPath | opaqueArea () const |
Reimplemented Function More... | |
void | paint (QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget=0) |
Reimplemented Function More... | |
QGraphicsItemGroup (QGraphicsItem *parent=0) | |
Constructs a QGraphicsItemGroup. More... | |
void | removeFromGroup (QGraphicsItem *item) |
Removes the specified item from this group. More... | |
int | type () const |
Reimplemented Function More... | |
~QGraphicsItemGroup () | |
Destroys the QGraphicsItemGroup. More... | |
Public Functions inherited from QGraphicsItem | |
bool | acceptDrops () const |
Returns true if this item can accept drag and drop events; otherwise, returns false. More... | |
Qt::MouseButtons | acceptedMouseButtons () const |
Returns the mouse buttons that this item accepts mouse events for. More... | |
bool | acceptHoverEvents () const |
Returns true if an item accepts hover events (QGraphicsSceneHoverEvent); otherwise, returns false. More... | |
bool | acceptsHoverEvents () const |
Call acceptHoverEvents() instead. More... | |
bool | acceptTouchEvents () const |
Returns true if an item accepts touch events; otherwise, returns false. More... | |
virtual void | advance (int phase) |
This virtual function is called twice for all items by the QGraphicsScene::advance() slot. More... | |
QRegion | boundingRegion (const QTransform &itemToDeviceTransform) const |
Returns the bounding region for this item. More... | |
qreal | boundingRegionGranularity () const |
Returns the item's bounding region granularity; a value between and including 0 and 1. More... | |
CacheMode | cacheMode () const |
Returns the cache mode for this item. More... | |
QList< QGraphicsItem * > | childItems () const |
Returns a list of this item's children. More... | |
QList< QGraphicsItem * > | children () const |
Use childItems() instead. More... | |
QRectF | childrenBoundingRect () const |
Returns the bounding rect of this item's descendants (i.e., its children, their children, etc.) in local coordinates. More... | |
void | clearFocus () |
Takes keyboard input focus from the item. More... | |
QPainterPath | clipPath () const |
Returns this item's clip path, or an empty QPainterPath if this item is not clipped. More... | |
virtual bool | collidesWithItem (const QGraphicsItem *other, Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const |
Returns true if this item collides with other; otherwise returns false. More... | |
virtual bool | collidesWithPath (const QPainterPath &path, Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const |
Returns true if this item collides with path. More... | |
QList< QGraphicsItem * > | collidingItems (Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const |
Returns a list of all items that collide with this item. More... | |
QGraphicsItem * | commonAncestorItem (const QGraphicsItem *other) const |
Returns the closest common ancestor item of this item and other, or 0 if either other is 0, or there is no common ancestor. More... | |
virtual bool | contains (const QPointF &point) const |
Returns true if this item contains point, which is in local coordinates; otherwise, false is returned. More... | |
QCursor | cursor () const |
Returns the current cursor shape for the item. More... | |
QVariant | data (int key) const |
Returns this item's custom data for the key key as a QVariant. More... | |
QTransform | deviceTransform (const QTransform &viewportTransform) const |
Returns this item's device transformation matrix, using viewportTransform to map from scene to device coordinates. More... | |
qreal | effectiveOpacity () const |
Returns this item's effective opacity, which is between 0. More... | |
void | ensureVisible (const QRectF &rect=QRectF(), int xmargin=50, int ymargin=50) |
If this item is part of a scene that is viewed by a QGraphicsView, this convenience function will attempt to scroll the view to ensure that rect is visible inside the view's viewport. More... | |
void | ensureVisible (qreal x, qreal y, qreal w, qreal h, int xmargin=50, int ymargin=50) |
This convenience function is equivalent to calling ensureVisible(QRectF(x, y, w, h), xmargin, ymargin): More... | |
bool | filtersChildEvents () const |
Returns true if this item filters child events (i. More... | |
GraphicsItemFlags | flags () const |
Returns this item's flags. More... | |
QGraphicsItem * | focusItem () const |
If this item, a child or descendant of this item currently has input focus, this function will return a pointer to that item. More... | |
QGraphicsItem * | focusProxy () const |
Returns this item's focus proxy, or 0 if this item has no focus proxy. More... | |
QGraphicsItem * | focusScopeItem () const |
Returns this item's focus scope item. More... | |
void | grabKeyboard () |
Grabs the keyboard input. More... | |
void | grabMouse () |
Grabs the mouse input. More... | |
QGraphicsEffect * | graphicsEffect () const |
Returns a pointer to this item's effect if it has one; otherwise 0. More... | |
QGraphicsItemGroup * | group () const |
Returns a pointer to this item's item group, or 0 if this item is not member of a group. More... | |
bool | handlesChildEvents () const |
Returns true if this item handles child events (i. More... | |
bool | hasCursor () const |
Returns true if this item has a cursor set; otherwise, false is returned. More... | |
bool | hasFocus () const |
Returns true if this item is active, and it or its focus proxy has keyboard input focus; otherwise, returns false. More... | |
void | hide () |
Hides the item. More... | |
Qt::InputMethodHints | inputMethodHints () const |
Returns the current input method hints of this item. More... | |
void | installSceneEventFilter (QGraphicsItem *filterItem) |
Installs an event filter for this item on filterItem, causing all events for this item to first pass through filterItem's sceneEventFilter() function. More... | |
bool | isActive () const |
Returns true if this item is active; otherwise returns false. More... | |
bool | isAncestorOf (const QGraphicsItem *child) const |
Returns true if this item is an ancestor of child (i.e., if this item is child's parent, or one of child's parent's ancestors). More... | |
bool | isBlockedByModalPanel (QGraphicsItem **blockingPanel=0) const |
Returns true if this item is blocked by a modal panel, false otherwise. More... | |
bool | isClipped () const |
Returns true if this item is clipped. More... | |
bool | isEnabled () const |
Returns true if the item is enabled; otherwise, false is returned. More... | |
bool | isObscured () const |
Returns true if this item's bounding rect is completely obscured by the opaque shape of any of colliding items above it (i.e., with a higher Z value than this item). More... | |
bool | isObscured (const QRectF &rect) const |
Returns true if rect is completely obscured by the opaque shape of any of colliding items above it (i. More... | |
bool | isObscured (qreal x, qreal y, qreal w, qreal h) const |
This convenience function is equivalent to calling isObscured(QRectF(x, y, w, h)). More... | |
bool | isPanel () const |
Returns true if the item is a panel; otherwise returns false. More... | |
bool | isSelected () const |
Returns true if this item is selected; otherwise, false is returned. More... | |
bool | isUnderMouse () const |
Returns true if this item is currently under the mouse cursor in one of the views; otherwise, false is returned. More... | |
bool | isVisible () const |
Returns true if the item is visible; otherwise, false is returned. More... | |
bool | isVisibleTo (const QGraphicsItem *parent) const |
Returns true if the item is visible to parent; otherwise, false is returned. More... | |
bool | isWidget () const |
Returns true if this item is a widget (i. More... | |
bool | isWindow () const |
Returns true if the item is a QGraphicsWidget window, otherwise returns false. More... | |
QTransform | itemTransform (const QGraphicsItem *other, bool *ok=0) const |
Returns a QTransform that maps coordinates from this item to other. More... | |
QPointF | mapFromItem (const QGraphicsItem *item, const QPointF &point) const |
Maps the point point, which is in item's coordinate system, to this item's coordinate system, and returns the mapped coordinate. More... | |
QPolygonF | mapFromItem (const QGraphicsItem *item, const QRectF &rect) const |
Maps the rectangle rect, which is in item's coordinate system, to this item's coordinate system, and returns the mapped rectangle as a polygon. More... | |
QPolygonF | mapFromItem (const QGraphicsItem *item, const QPolygonF &polygon) const |
Maps the polygon polygon, which is in item's coordinate system, to this item's coordinate system, and returns the mapped polygon. More... | |
QPainterPath | mapFromItem (const QGraphicsItem *item, const QPainterPath &path) const |
Maps the path path, which is in item's coordinate system, to this item's coordinate system, and returns the mapped path. More... | |
QPointF | mapFromItem (const QGraphicsItem *item, qreal x, qreal y) const |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.This convenience function is equivalent to calling mapFromItem(item, QPointF(x, y)). More... | |
QPolygonF | mapFromItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const |
QPointF | mapFromParent (const QPointF &point) const |
Maps the point point, which is in this item's parent's coordinate system, to this item's coordinate system, and returns the mapped coordinate. More... | |
QPolygonF | mapFromParent (const QRectF &rect) const |
Maps the rectangle rect, which is in this item's parent's coordinate system, to this item's coordinate system, and returns the mapped rectangle as a polygon. More... | |
QPolygonF | mapFromParent (const QPolygonF &polygon) const |
Maps the polygon polygon, which is in this item's parent's coordinate system, to this item's coordinate system, and returns the mapped polygon. More... | |
QPainterPath | mapFromParent (const QPainterPath &path) const |
Maps the path path, which is in this item's parent's coordinate system, to this item's coordinate system, and returns the mapped path. More... | |
QPointF | mapFromParent (qreal x, qreal y) const |
This convenience function is equivalent to calling mapFromParent(QPointF(x, y)). More... | |
QPolygonF | mapFromParent (qreal x, qreal y, qreal w, qreal h) const |
This convenience function is equivalent to calling mapFromItem(QRectF(x, y, w, h)). More... | |
QPointF | mapFromScene (const QPointF &point) const |
Maps the point point, which is in this item's scene's coordinate system, to this item's coordinate system, and returns the mapped coordinate. More... | |
QPolygonF | mapFromScene (const QRectF &rect) const |
Maps the rectangle rect, which is in this item's scene's coordinate system, to this item's coordinate system, and returns the mapped rectangle as a polygon. More... | |
QPolygonF | mapFromScene (const QPolygonF &polygon) const |
Maps the polygon polygon, which is in this item's scene's coordinate system, to this item's coordinate system, and returns the mapped polygon. More... | |
QPainterPath | mapFromScene (const QPainterPath &path) const |
Maps the path path, which is in this item's scene's coordinate system, to this item's coordinate system, and returns the mapped path. More... | |
QPointF | mapFromScene (qreal x, qreal y) const |
This convenience function is equivalent to calling mapFromScene(QPointF(x, y)). More... | |
QPolygonF | mapFromScene (qreal x, qreal y, qreal w, qreal h) const |
This convenience function is equivalent to calling mapFromScene(QRectF(x, y, w, h)). More... | |
QRectF | mapRectFromItem (const QGraphicsItem *item, const QRectF &rect) const |
Maps the rectangle rect, which is in item's coordinate system, to this item's coordinate system, and returns the mapped rectangle as a new rectangle (i. More... | |
QRectF | mapRectFromItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const |
QRectF | mapRectFromParent (const QRectF &rect) const |
Maps the rectangle rect, which is in this item's parent's coordinate system, to this item's coordinate system, and returns the mapped rectangle as a new rectangle (i. More... | |
QRectF | mapRectFromParent (qreal x, qreal y, qreal w, qreal h) const |
This convenience function is equivalent to calling mapRectFromParent(QRectF(x, y, w, h)). More... | |
QRectF | mapRectFromScene (const QRectF &rect) const |
Maps the rectangle rect, which is in scene coordinates, to this item's coordinate system, and returns the mapped rectangle as a new rectangle (i. More... | |
QRectF | mapRectFromScene (qreal x, qreal y, qreal w, qreal h) const |
This convenience function is equivalent to calling mapRectFromScene(QRectF(x, y, w, h)). More... | |
QRectF | mapRectToItem (const QGraphicsItem *item, const QRectF &rect) const |
Maps the rectangle rect, which is in this item's coordinate system, to item's coordinate system, and returns the mapped rectangle as a new rectangle (i. More... | |
QRectF | mapRectToItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const |
QRectF | mapRectToParent (const QRectF &rect) const |
Maps the rectangle rect, which is in this item's coordinate system, to its parent's coordinate system, and returns the mapped rectangle as a new rectangle (i. More... | |
QRectF | mapRectToParent (qreal x, qreal y, qreal w, qreal h) const |
This convenience function is equivalent to calling mapRectToParent(QRectF(x, y, w, h)). More... | |
QRectF | mapRectToScene (const QRectF &rect) const |
Maps the rectangle rect, which is in this item's coordinate system, to the scene coordinate system, and returns the mapped rectangle as a new rectangle (i. More... | |
QRectF | mapRectToScene (qreal x, qreal y, qreal w, qreal h) const |
This convenience function is equivalent to calling mapRectToScene(QRectF(x, y, w, h)). More... | |
QPointF | mapToItem (const QGraphicsItem *item, const QPointF &point) const |
Maps the point point, which is in this item's coordinate system, to item's coordinate system, and returns the mapped coordinate. More... | |
QPolygonF | mapToItem (const QGraphicsItem *item, const QRectF &rect) const |
Maps the rectangle rect, which is in this item's coordinate system, to item's coordinate system, and returns the mapped rectangle as a polygon. More... | |
QPolygonF | mapToItem (const QGraphicsItem *item, const QPolygonF &polygon) const |
Maps the polygon polygon, which is in this item's coordinate system, to item's coordinate system, and returns the mapped polygon. More... | |
QPainterPath | mapToItem (const QGraphicsItem *item, const QPainterPath &path) const |
Maps the path path, which is in this item's coordinate system, to item's coordinate system, and returns the mapped path. More... | |
QPointF | mapToItem (const QGraphicsItem *item, qreal x, qreal y) const |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.This convenience function is equivalent to calling mapToItem(item, QPointF(x, y)). More... | |
QPolygonF | mapToItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const |
QPointF | mapToParent (const QPointF &point) const |
Maps the point point, which is in this item's coordinate system, to its parent's coordinate system, and returns the mapped coordinate. More... | |
QPolygonF | mapToParent (const QRectF &rect) const |
Maps the rectangle rect, which is in this item's coordinate system, to its parent's coordinate system, and returns the mapped rectangle as a polygon. More... | |
QPolygonF | mapToParent (const QPolygonF &polygon) const |
Maps the polygon polygon, which is in this item's coordinate system, to its parent's coordinate system, and returns the mapped polygon. More... | |
QPainterPath | mapToParent (const QPainterPath &path) const |
Maps the path path, which is in this item's coordinate system, to its parent's coordinate system, and returns the mapped path. More... | |
QPointF | mapToParent (qreal x, qreal y) const |
This convenience function is equivalent to calling mapToParent(QPointF(x, y)). More... | |
QPolygonF | mapToParent (qreal x, qreal y, qreal w, qreal h) const |
This convenience function is equivalent to calling mapToParent(QRectF(x, y, w, h)). More... | |
QPointF | mapToScene (const QPointF &point) const |
Maps the point point, which is in this item's coordinate system, to the scene's coordinate system, and returns the mapped coordinate. More... | |
QPolygonF | mapToScene (const QRectF &rect) const |
Maps the rectangle rect, which is in this item's coordinate system, to the scene's coordinate system, and returns the mapped rectangle as a polygon. More... | |
QPolygonF | mapToScene (const QPolygonF &polygon) const |
Maps the polygon polygon, which is in this item's coordinate system, to the scene's coordinate system, and returns the mapped polygon. More... | |
QPainterPath | mapToScene (const QPainterPath &path) const |
Maps the path path, which is in this item's coordinate system, to the scene's coordinate system, and returns the mapped path. More... | |
QPointF | mapToScene (qreal x, qreal y) const |
This convenience function is equivalent to calling mapToScene(QPointF(x, y)). More... | |
QPolygonF | mapToScene (qreal x, qreal y, qreal w, qreal h) const |
This convenience function is equivalent to calling mapToScene(QRectF(x, y, w, h)). More... | |
QMatrix | matrix () const |
Returns the item's affine transformation matrix. More... | |
void | moveBy (qreal dx, qreal dy) |
Moves the item by dx points horizontally, and dy point vertically. More... | |
qreal | opacity () const |
Returns this item's local opacity, which is between 0. More... | |
QGraphicsItem * | panel () const |
Returns the item's panel, or 0 if this item does not have a panel. More... | |
PanelModality | panelModality () const |
Returns the modality for this item. More... | |
QGraphicsItem * | parentItem () const |
Returns a pointer to this item's parent item. More... | |
QGraphicsObject * | parentObject () const |
Returns a pointer to the item's parent, cast to a QGraphicsObject. More... | |
QGraphicsWidget * | parentWidget () const |
Returns a pointer to the item's parent widget. More... | |
QPointF | pos () const |
Returns the position of the item in parent coordinates. More... | |
QGraphicsItem (QGraphicsItem *parent=0) | |
Constructs a QGraphicsItem with the given parent item. More... | |
void | removeSceneEventFilter (QGraphicsItem *filterItem) |
Removes an event filter on this item from filterItem. More... | |
void | resetMatrix () |
Use resetTransform() instead. More... | |
void | resetTransform () |
Resets this item's transformation matrix to the identity matrix or all the transformation properties to their default values. More... | |
void | rotate (qreal angle) |
Use. More... | |
qreal | rotation () const |
Returns the clockwise rotation, in degrees, around the Z axis. More... | |
void | scale (qreal sx, qreal sy) |
Use. More... | |
qreal | scale () const |
Returns the scale factor of the item. More... | |
QGraphicsScene * | scene () const |
Returns the current scene for the item, or 0 if the item is not stored in a scene. More... | |
QRectF | sceneBoundingRect () const |
Returns the bounding rect of this item in scene coordinates, by combining sceneTransform() with boundingRect(). More... | |
QMatrix | sceneMatrix () const |
Use sceneTransform() instead. More... | |
QPointF | scenePos () const |
Returns the item's position in scene coordinates. More... | |
QTransform | sceneTransform () const |
Returns this item's scene transformation matrix. More... | |
void | scroll (qreal dx, qreal dy, const QRectF &rect=QRectF()) |
Scrolls the contents of rect by dx, dy. More... | |
void | setAcceptDrops (bool on) |
If on is true, this item will accept drag and drop events; otherwise, it is transparent for drag and drop events. More... | |
void | setAcceptedMouseButtons (Qt::MouseButtons buttons) |
Sets the mouse buttons that this item accepts mouse events for. More... | |
void | setAcceptHoverEvents (bool enabled) |
If enabled is true, this item will accept hover events; otherwise, it will ignore them. More... | |
void | setAcceptsHoverEvents (bool enabled) |
Use setAcceptHoverEvents(enabled) instead. More... | |
void | setAcceptTouchEvents (bool enabled) |
If enabled is true, this item will accept touch events; otherwise, it will ignore them. More... | |
void | setActive (bool active) |
If active is true, and the scene is active, this item's panel will be activated. More... | |
void | setBoundingRegionGranularity (qreal granularity) |
Sets the bounding region granularity to granularity; a value between and including 0 and 1. More... | |
void | setCacheMode (CacheMode mode, const QSize &cacheSize=QSize()) |
Sets the item's cache mode to mode. More... | |
void | setCursor (const QCursor &cursor) |
Sets the current cursor shape for the item to cursor. More... | |
void | setData (int key, const QVariant &value) |
Sets this item's custom data for the key key to value. More... | |
void | setEnabled (bool enabled) |
If enabled is true, the item is enabled; otherwise, it is disabled. More... | |
void | setFiltersChildEvents (bool enabled) |
If enabled is true, this item is set to filter all events for all its children (i. More... | |
void | setFlag (GraphicsItemFlag flag, bool enabled=true) |
If enabled is true, the item flag flag is enabled; otherwise, it is disabled. More... | |
void | setFlags (GraphicsItemFlags flags) |
Sets the item flags to flags. More... | |
void | setFocus (Qt::FocusReason focusReason=Qt::OtherFocusReason) |
Gives keyboard input focus to this item. More... | |
void | setFocusProxy (QGraphicsItem *item) |
Sets the item's focus proxy to item. More... | |
void | setGraphicsEffect (QGraphicsEffect *effect) |
Sets effect as the item's effect. More... | |
void | setGroup (QGraphicsItemGroup *group) |
Adds this item to the item group group. More... | |
void | setHandlesChildEvents (bool enabled) |
If enabled is true, this item is set to handle all events for all its children (i. More... | |
void | setInputMethodHints (Qt::InputMethodHints hints) |
Sets the current input method hints of this item to hints. More... | |
void | setMatrix (const QMatrix &matrix, bool combine=false) |
Sets the item's affine transformation matrix. More... | |
void | setOpacity (qreal opacity) |
Sets this item's local opacity, between 0. More... | |
void | setPanelModality (PanelModality panelModality) |
Sets the modality for this item to panelModality. More... | |
void | setParentItem (QGraphicsItem *parent) |
Sets this item's parent item to newParent. More... | |
void | setPos (const QPointF &pos) |
Sets the position of the item to pos, which is in parent coordinates. More... | |
void | setPos (qreal x, qreal y) |
This convenience function is equivalent to calling setPos(QPointF(x, y)). More... | |
void | setRotation (qreal angle) |
Sets the clockwise rotation angle, in degrees, around the Z axis. More... | |
void | setScale (qreal scale) |
Sets the scale factor of the item. More... | |
void | setSelected (bool selected) |
If selected is true and this item is selectable, this item is selected; otherwise, it is unselected. More... | |
void | setToolTip (const QString &toolTip) |
Sets the item's tool tip to toolTip. More... | |
void | setTransform (const QTransform &matrix, bool combine=false) |
Sets the item's current transformation matrix to matrix. More... | |
void | setTransformations (const QList< QGraphicsTransform *> &transformations) |
Sets a list of graphics transformations (QGraphicsTransform) that currently apply to this item. More... | |
void | setTransformOriginPoint (const QPointF &origin) |
Sets the origin point for the transformation in item coordinates. More... | |
void | setTransformOriginPoint (qreal ax, qreal ay) |
Sets the origin point for the transformation in item coordinates. More... | |
void | setVisible (bool visible) |
If visible is true, the item is made visible. More... | |
void | setX (qreal x) |
Set's the x coordinate of the item's position. More... | |
void | setY (qreal y) |
Set's the y coordinate of the item's position. More... | |
void | setZValue (qreal z) |
Sets the Z-value of the item to z. More... | |
virtual QPainterPath | shape () const |
Returns the shape of this item as a QPainterPath in local coordinates. More... | |
void | shear (qreal sh, qreal sv) |
Use. More... | |
void | show () |
Shows the item. More... | |
void | stackBefore (const QGraphicsItem *sibling) |
Stacks this item before sibling, which must be a sibling item (i. More... | |
QGraphicsObject * | toGraphicsObject () |
Return the graphics item cast to a QGraphicsObject, if the class is actually a graphics object, 0 otherwise. More... | |
const QGraphicsObject * | toGraphicsObject () const |
Return the graphics item cast to a QGraphicsObject, if the class is actually a graphics object, 0 otherwise. More... | |
QString | toolTip () const |
Returns the item's tool tip, or an empty QString if no tool tip has been set. More... | |
QGraphicsItem * | topLevelItem () const |
Returns this item's top-level item. More... | |
QGraphicsWidget * | topLevelWidget () const |
Returns a pointer to the item's top level widget (i. More... | |
QTransform | transform () const |
Returns this item's transformation matrix. More... | |
QList< QGraphicsTransform * > | transformations () const |
Returns a list of graphics transforms that currently apply to this item. More... | |
QPointF | transformOriginPoint () const |
Returns the origin point for the transformation in item coordinates. More... | |
void | translate (qreal dx, qreal dy) |
Use setPos() or setTransformOriginPoint() instead. More... | |
void | ungrabKeyboard () |
Releases the keyboard grab. More... | |
void | ungrabMouse () |
Releases the mouse grab. More... | |
void | unsetCursor () |
Clears the cursor from this item. More... | |
void | update (const QRectF &rect=QRectF()) |
Schedules a redraw of the area covered by rect in this item. More... | |
void | update (qreal x, qreal y, qreal width, qreal height) |
This convenience function is equivalent to calling update(QRectF(x, y, width, height)). More... | |
QGraphicsWidget * | window () const |
Returns the item's window, or 0 if this item does not have a window. More... | |
qreal | x () const |
This convenience function is equivalent to calling pos(). More... | |
qreal | y () const |
This convenience function is equivalent to calling pos(). More... | |
qreal | zValue () const |
Returns the Z-value of the item. More... | |
virtual | ~QGraphicsItem () |
Destroys the QGraphicsItem and all its children. More... | |
Additional Inherited Members | |
Protected Types inherited from QGraphicsItem | |
enum | Extension { UserExtension = 0x80000000 } |
Note: This is provided as a hook to avoid future problems related to adding virtual functions. More... | |
Protected Functions inherited from QGraphicsItem | |
void | addToIndex () |
Adds this item to the scene's index. More... | |
virtual void | contextMenuEvent (QGraphicsSceneContextMenuEvent *event) |
This event handler can be reimplemented in a subclass to process context menu events. More... | |
virtual void | dragEnterEvent (QGraphicsSceneDragDropEvent *event) |
This event handler, for event event, can be reimplemented to receive drag enter events for this item. More... | |
virtual void | dragLeaveEvent (QGraphicsSceneDragDropEvent *event) |
This event handler, for event event, can be reimplemented to receive drag leave events for this item. More... | |
virtual void | dragMoveEvent (QGraphicsSceneDragDropEvent *event) |
This event handler, for event event, can be reimplemented to receive drag move events for this item. More... | |
virtual void | dropEvent (QGraphicsSceneDragDropEvent *event) |
This event handler, for event event, can be reimplemented to receive drop events for this item. More... | |
virtual QVariant | extension (const QVariant &variant) const |
Note: This is provided as a hook to avoid future problems related to adding virtual functions. More... | |
virtual void | focusInEvent (QFocusEvent *event) |
This event handler, for event event, can be reimplemented to receive focus in events for this item. More... | |
virtual void | focusOutEvent (QFocusEvent *event) |
This event handler, for event event, can be reimplemented to receive focus out events for this item. More... | |
virtual void | hoverEnterEvent (QGraphicsSceneHoverEvent *event) |
This event handler, for event event, can be reimplemented to receive hover enter events for this item. More... | |
virtual void | hoverLeaveEvent (QGraphicsSceneHoverEvent *event) |
This event handler, for event event, can be reimplemented to receive hover leave events for this item. More... | |
virtual void | hoverMoveEvent (QGraphicsSceneHoverEvent *event) |
This event handler, for event event, can be reimplemented to receive hover move events for this item. More... | |
virtual void | inputMethodEvent (QInputMethodEvent *event) |
This event handler, for event event, can be reimplemented to receive input method events for this item. More... | |
virtual QVariant | inputMethodQuery (Qt::InputMethodQuery query) const |
This method is only relevant for input items. More... | |
virtual QVariant | itemChange (GraphicsItemChange change, const QVariant &value) |
This virtual function is called by QGraphicsItem to notify custom items that some part of the item's state changes. More... | |
virtual void | keyPressEvent (QKeyEvent *event) |
This event handler, for event event, can be reimplemented to receive key press events for this item. More... | |
virtual void | keyReleaseEvent (QKeyEvent *event) |
This event handler, for event event, can be reimplemented to receive key release events for this item. More... | |
virtual void | mouseDoubleClickEvent (QGraphicsSceneMouseEvent *event) |
This event handler, for event event, can be reimplemented to receive mouse doubleclick events for this item. More... | |
virtual void | mouseMoveEvent (QGraphicsSceneMouseEvent *event) |
This event handler, for event event, can be reimplemented to receive mouse move events for this item. More... | |
virtual void | mousePressEvent (QGraphicsSceneMouseEvent *event) |
This event handler, for event event, can be reimplemented to receive mouse press events for this item. More... | |
virtual void | mouseReleaseEvent (QGraphicsSceneMouseEvent *event) |
This event handler, for event event, can be reimplemented to receive mouse release events for this item. More... | |
void | prepareGeometryChange () |
Prepares the item for a geometry change. More... | |
QGraphicsItem (QGraphicsItemPrivate &dd, QGraphicsItem *parent, QGraphicsScene *scene) | |
void | removeFromIndex () |
Removes this item from the scene's index. More... | |
virtual bool | sceneEvent (QEvent *event) |
This virtual function receives events to this item. More... | |
virtual bool | sceneEventFilter (QGraphicsItem *watched, QEvent *event) |
Filters events for the item watched. More... | |
virtual void | setExtension (Extension extension, const QVariant &variant) |
Note: This is provided as a hook to avoid future problems related to adding virtual functions. More... | |
virtual bool | supportsExtension (Extension extension) const |
Note: This is provided as a hook to avoid future problems related to adding virtual functions. More... | |
void | updateMicroFocus () |
Updates the item's micro focus. More... | |
virtual void | wheelEvent (QGraphicsSceneWheelEvent *event) |
This event handler, for event event, can be reimplemented to receive wheel events for this item. More... | |
Protected Variables inherited from QGraphicsItem | |
QScopedPointer< QGraphicsItemPrivate > | d_ptr |
Related Functions inherited from QGraphicsItem | |
T | qgraphicsitem_cast (QGraphicsItem *item) |
The QGraphicsItemGroup class provides a container that treats a group of items as a single item.
A QGraphicsItemGroup is a special type of compound item that treats itself and all its children as one item (i.e., all events and geometries for all children are merged together). It's common to use item groups in presentation tools, when the user wants to group several smaller items into one big item in order to simplify moving and copying of items.
If all you want is to store items inside other items, you can use any QGraphicsItem directly by passing a suitable parent to setParentItem().
The boundingRect() function of QGraphicsItemGroup returns the bounding rectangle of all items in the item group. QGraphicsItemGroup ignores the ItemIgnoresTransformations flag on its children (i.e., with respect to the geometry of the group item, the children are treated as if they were transformable).
There are two ways to construct an item group. The easiest and most common approach is to pass a list of items (e.g., all selected items) to QGraphicsScene::createItemGroup(), which returns a new QGraphicsItemGroup item. The other approach is to manually construct a QGraphicsItemGroup item, add it to the scene calling QGraphicsScene::addItem(), and then add items to the group manually, one at a time by calling addToGroup(). To dismantle ("ungroup") an item group, you can either call QGraphicsScene::destroyItemGroup(), or you can manually remove all items from the group by calling removeFromGroup().
The operation of adding and removing items preserves the items' scene-relative position and transformation, as opposed to calling setParentItem(), where only the child item's parent-relative position and transformation are kept.
The addtoGroup() function reparents the target item to this item group, keeping the item's position and transformation intact relative to the scene. Visually, this means that items added via addToGroup() will remain completely unchanged as a result of this operation, regardless of the item or the group's current position or transformation; although the item's position and matrix are likely to change.
The removeFromGroup() function has similar semantics to setParentItem(); it reparents the item to the parent item of the item group. As with addToGroup(), the item's scene-relative position and transformation remain intact.
Definition at line 1111 of file qgraphicsitem.h.
anonymous enum |
QGraphicsItemGroup::QGraphicsItemGroup | ( | QGraphicsItem * | parent = 0 | ) |
Constructs a QGraphicsItemGroup.
parent is passed to QGraphicsItem's constructor.
Definition at line 11618 of file qgraphicsitem.cpp.
QGraphicsItemGroup::~QGraphicsItemGroup | ( | ) |
void QGraphicsItemGroup::addToGroup | ( | QGraphicsItem * | item | ) |
Adds the given item and item's child items to this item group.
The item and child items will be reparented to this group, but its position and transformation relative to the scene will stay intact.
Definition at line 11643 of file qgraphicsitem.cpp.
Referenced by QGraphicsScene::createItemGroup(), and QGraphicsItem::setGroup().
|
virtual |
Returns the bounding rect of this group item, and all its children.
Reimplemented Function
Implements QGraphicsItem.
Definition at line 11758 of file qgraphicsitem.cpp.
Referenced by QGraphicsItemEffectSourcePrivate::pixmap().
|
virtual |
Reimplemented Function
Reimplemented from QGraphicsItem.
Definition at line 11781 of file qgraphicsitem.cpp.
|
virtual |
Reimplemented Function
Reimplemented from QGraphicsItem.
Definition at line 11789 of file qgraphicsitem.cpp.
|
virtual |
Reimplemented Function
Implements QGraphicsItem.
Definition at line 11767 of file qgraphicsitem.cpp.
void QGraphicsItemGroup::removeFromGroup | ( | QGraphicsItem * | item | ) |
Removes the specified item from this group.
The item will be reparented to this group's parent item, or to 0 if this group has no parent. Its position and transformation relative to the scene will stay intact.
Definition at line 11701 of file qgraphicsitem.cpp.
Referenced by QGraphicsScene::destroyItemGroup(), and QGraphicsItem::setGroup().
|
virtual |
Reimplemented Function
Reimplemented from QGraphicsItem.
Definition at line 11797 of file qgraphicsitem.cpp.