 |
Qt 4.8
|
|
Qt 4.8
|
The QGraphicsWidget class is the base class for all widget items in a QGraphicsScene. More...
#include <qgraphicswidget.h>
Public Slots | |
| bool | close () |
| Call this function to close the widget. More... | |
 Public Slots inherited from QObject | |
| void | deleteLater () |
| Schedules this object for deletion. More... | |
Signals | |
| void | geometryChanged () |
| This signal gets emitted whenever the geometry is changed in setGeometry(). More... | |
| void | layoutChanged () |
| This signal gets emitted whenever the layout of the item changes. More... | |
| Signals inherited from QGraphicsObject | |
| void | childrenChanged () |
| This signal gets emitted whenever the children list changes. More... | |
| void | enabledChanged () |
| This signal gets emitted whenever the item get's enabled or disabled. More... | |
| void | heightChanged () |
| void | opacityChanged () |
| This signal gets emitted whenever the opacity of the item changes. More... | |
| void | parentChanged () |
| This signal gets emitted whenever the parent of the item changes. More... | |
| void | rotationChanged () |
| This signal gets emitted whenever the roation of the item changes. More... | |
| void | scaleChanged () |
| This signal is emitted when the scale of the item changes. More... | |
| void | visibleChanged () |
| This signal gets emitted whenever the visibility of the item changes. More... | |
| void | widthChanged () |
| void | xChanged () |
| This signal gets emitted whenever the x position of the item changes. More... | |
| void | yChanged () |
| This signal gets emitted whenever the y position of the item changes. More... | |
| void | zChanged () |
| This signal gets emitted whenever the z value of the item changes. More... | |
| Signals inherited from QObject | |
| void | destroyed (QObject *=0) |
| This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More... | |
Public Functions | |
| QList< QAction * > | actions () const |
| Returns the (possibly empty) list of this widget's actions. More... | |
| void | addAction (QAction *action) |
| Appends the action action to this widget's list of actions. More... | |
| void | addActions (QList< QAction *> actions) |
| Appends the actions actions to this widget's list of actions. More... | |
| void | adjustSize () |
| Adjusts the size of the widget to its effective preferred size hint. More... | |
| bool | autoFillBackground () const |
| QRectF | boundingRect () const |
| Reimplemented Function More... | |
| Qt::FocusPolicy | focusPolicy () const |
| QGraphicsWidget * | focusWidget () const |
| If this widget, a child or descendant of this widget currently has input focus, this function will return a pointer to that widget. More... | |
| QFont | font () const |
| void | getContentsMargins (qreal *left, qreal *top, qreal *right, qreal *bottom) const |
| Gets the widget's contents margins. More... | |
| void | getWindowFrameMargins (qreal *left, qreal *top, qreal *right, qreal *bottom) const |
| Gets the widget's window frame margins. More... | |
| int | grabShortcut (const QKeySequence &sequence, Qt::ShortcutContext context=Qt::WindowShortcut) |
| Adds a shortcut to Qt's shortcut system that watches for the given key sequence in the given context. More... | |
| void | insertAction (QAction *before, QAction *action) |
| Inserts the action action to this widget's list of actions, before the action before. More... | |
| void | insertActions (QAction *before, QList< QAction *> actions) |
| Inserts the actions actions to this widget's list of actions, before the action before. More... | |
| bool | isActiveWindow () const |
| Returns true if this widget's window is in the active window, or if the widget does not have a window but is in an active scene (i.e., a scene that currently has focus). More... | |
| QGraphicsLayout * | layout () const |
| Qt::LayoutDirection | layoutDirection () const |
| void | paint (QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget=0) |
| Reimplemented Function More... | |
| virtual void | paintWindowFrame (QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget=0) |
| This virtual function is called by QGraphicsScene to draw the window frame for windows using painter, option, and widget, in local coordinates. More... | |
| QPalette | palette () const |
| QGraphicsWidget (QGraphicsItem *parent=0, Qt::WindowFlags wFlags=0) | |
| Constructs a QGraphicsWidget instance. More... | |
| QRectF | rect () const |
| Returns the item's local rect as a QRectF. More... | |
| void | releaseShortcut (int id) |
| Removes the shortcut with the given id from Qt's shortcut system. More... | |
| void | removeAction (QAction *action) |
| Removes the action action from this widget's list of actions. More... | |
| void | resize (const QSizeF &size) |
| void | resize (qreal w, qreal h) |
| This convenience function is equivalent to calling resize(QSizeF(w, h)). More... | |
| void | setAttribute (Qt::WidgetAttribute attribute, bool on=true) |
| If on is true, this function enables attribute; otherwise attribute is disabled. More... | |
| void | setAutoFillBackground (bool enabled) |
| void | setContentsMargins (qreal left, qreal top, qreal right, qreal bottom) |
| Sets the widget's contents margins to left, top, right and bottom. More... | |
| void | setFocusPolicy (Qt::FocusPolicy policy) |
| void | setFont (const QFont &font) |
| void | setGeometry (const QRectF &rect) |
| This virtual function sets the geometry of the QGraphicsLayoutItem to rect, which is in parent coordinates (e. More... | |
| void | setGeometry (qreal x, qreal y, qreal w, qreal h) |
| This convenience function is equivalent to calling setGeometry(QRectF( x, y, w, h)). More... | |
| void | setLayout (QGraphicsLayout *layout) |
| Sets the layout for this widget to layout. More... | |
| void | setLayoutDirection (Qt::LayoutDirection direction) |
| void | setPalette (const QPalette &palette) |
| void | setShortcutAutoRepeat (int id, bool enabled=true) |
| If enabled is true, auto repeat of the shortcut with the given id is enabled; otherwise it is disabled. More... | |
| void | setShortcutEnabled (int id, bool enabled=true) |
| If enabled is true, the shortcut with the given id is enabled; otherwise the shortcut is disabled. More... | |
| void | setStyle (QStyle *style) |
| Sets the widget's style to style. More... | |
| void | setWindowFlags (Qt::WindowFlags wFlags) |
| void | setWindowFrameMargins (qreal left, qreal top, qreal right, qreal bottom) |
| Sets the widget's window frame margins to left, top, right and bottom. More... | |
| void | setWindowTitle (const QString &title) |
| QPainterPath | shape () const |
| Reimplemented Function More... | |
| QSizeF | size () const |
| QStyle * | style () const |
| Returns a pointer to the widget's style. More... | |
| bool | testAttribute (Qt::WidgetAttribute attribute) const |
| Returns true if attribute is enabled for this widget; otherwise, returns false. More... | |
| int | type () const |
| Reimplemented Function More... | |
| void | unsetLayoutDirection () |
| void | unsetWindowFrameMargins () |
| Resets the window frame margins to the default value, provided by the style. More... | |
| Qt::WindowFlags | windowFlags () const |
| QRectF | windowFrameGeometry () const |
| Returns the widget's geometry in parent coordinates including any window frame. More... | |
| QRectF | windowFrameRect () const |
| Returns the widget's local rect including any window frame. More... | |
| QString | windowTitle () const |
| Qt::WindowType | windowType () const |
| Returns the widgets window type. More... | |
| ~QGraphicsWidget () | |
| Destroys the QGraphicsWidget instance. More... | |
| Public Functions inherited from QGraphicsObject | |
| void | grabGesture (Qt::GestureType type, Qt::GestureFlags flags=Qt::GestureFlags()) |
| Subscribes the graphics object to the given gesture with specific flags. More... | |
| QGraphicsObject (QGraphicsItem *parent=0) | |
| Constructs a QGraphicsObject with parent. More... | |
| void | ungrabGesture (Qt::GestureType type) |
| Unsubscribes the graphics object from the given gesture. More... | |
| Public Functions inherited from QObject | |
| bool | blockSignals (bool b) |
| If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More... | |
| const QObjectList & | children () const |
| Returns a list of child objects. More... | |
| bool | connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const |
| bool | disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0) |
| bool | disconnect (const QObject *receiver, const char *member=0) |
| void | dumpObjectInfo () |
| Dumps information about signal connections, etc. More... | |
| void | dumpObjectTree () |
| Dumps a tree of children to the debug output. More... | |
| QList< QByteArray > | dynamicPropertyNames () const |
| Returns the names of all properties that were dynamically added to the object using setProperty(). More... | |
| virtual bool | eventFilter (QObject *, QEvent *) |
| Filters events if this object has been installed as an event filter for the watched object. More... | |
| template<typename T > | |
| T | findChild (const QString &aName=QString()) const |
| Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More... | |
| template<typename T > | |
| QList< T > | findChildren (const QString &aName=QString()) const |
| Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More... | |
| template<typename T > | |
| QList< T > | findChildren (const QRegExp &re) const |
| bool | inherits (const char *classname) const |
| Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More... | |
| void | installEventFilter (QObject *) |
| Installs an event filter filterObj on this object. More... | |
| bool | isWidgetType () const |
| Returns true if the object is a widget; otherwise returns false. More... | |
| void | killTimer (int id) |
| Kills the timer with timer identifier, id. More... | |
| virtual const QMetaObject * | metaObject () const |
| Returns a pointer to the meta-object of this object. More... | |
| void | moveToThread (QThread *thread) |
| Changes the thread affinity for this object and its children. More... | |
| QString | objectName () const |
| QObject * | parent () const |
| Returns a pointer to the parent object. More... | |
| QVariant | property (const char *name) const |
| Returns the value of the object's name property. More... | |
| Q_INVOKABLE | QObject (QObject *parent=0) |
| Constructs an object with parent object parent. More... | |
| void | removeEventFilter (QObject *) |
| Removes an event filter object obj from this object. More... | |
| void | setObjectName (const QString &name) |
| void | setParent (QObject *) |
| Makes the object a child of parent. More... | |
| bool | setProperty (const char *name, const QVariant &value) |
| Sets the value of the object's name property to value. More... | |
| void | setUserData (uint id, QObjectUserData *data) |
| bool | signalsBlocked () const |
| Returns true if signals are blocked; otherwise returns false. More... | |
| int | startTimer (int interval) |
| Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More... | |
| QThread * | thread () const |
| Returns the thread in which the object lives. More... | |
| QObjectUserData * | userData (uint id) const |
| virtual | ~QObject () |
| Destroys the object, deleting all its child objects. 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... | |
| virtual bool | isObscuredBy (const QGraphicsItem *item) const |
| Returns true if this item's bounding rect is completely obscured by the opaque shape of item. 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... | |
| virtual QPainterPath | opaqueArea () const |
| This virtual function returns a shape representing the area where this item is opaque. 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... | |
| 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... | |
| Public Functions inherited from QGraphicsLayoutItem | |
| QRectF | contentsRect () const |
| Returns the contents rect in local coordinates. More... | |
| QSizeF | effectiveSizeHint (Qt::SizeHint which, const QSizeF &constraint=QSizeF()) const |
| Returns the effective size hint for this QGraphicsLayoutItem. More... | |
| QRectF | geometry () const |
| Returns the item's geometry (e. More... | |
| QGraphicsItem * | graphicsItem () const |
| Returns the QGraphicsItem that this layout item represents. More... | |
| bool | isLayout () const |
| Returns true if this QGraphicsLayoutItem is a layout (e.g., is inherited by an object that arranges other QGraphicsLayoutItem objects); otherwise returns false. More... | |
| qreal | maximumHeight () const |
| Returns the maximum height. More... | |
| QSizeF | maximumSize () const |
| Returns the maximum size. More... | |
| qreal | maximumWidth () const |
| Returns the maximum width. More... | |
| qreal | minimumHeight () const |
| Returns the minimum height. More... | |
| QSizeF | minimumSize () const |
| Returns the minimum size. More... | |
| qreal | minimumWidth () const |
| Returns the minimum width. More... | |
| bool | ownedByLayout () const |
| Returns whether a layout should delete this item in its destructor. More... | |
| QGraphicsLayoutItem * | parentLayoutItem () const |
| Returns the parent of this QGraphicsLayoutItem, or 0 if there is no parent, or if the parent does not inherit from QGraphicsLayoutItem (QGraphicsLayoutItem is often used through multiple inheritance with QObject-derived classes). More... | |
| qreal | preferredHeight () const |
| Returns the preferred height. More... | |
| QSizeF | preferredSize () const |
| Returns the preferred size. More... | |
| qreal | preferredWidth () const |
| Returns the preferred width. More... | |
| QGraphicsLayoutItem (QGraphicsLayoutItem *parent=0, bool isLayout=false) | |
| Constructs the QGraphicsLayoutItem object. More... | |
| void | setMaximumHeight (qreal height) |
| Sets the maximum height to height. More... | |
| void | setMaximumSize (const QSizeF &size) |
| Sets the maximum size to size. More... | |
| void | setMaximumSize (qreal w, qreal h) |
| This convenience function is equivalent to calling setMaximumSize(QSizeF(w, h)). More... | |
| void | setMaximumWidth (qreal width) |
| Sets the maximum width to width. More... | |
| void | setMinimumHeight (qreal height) |
| Sets the minimum height to height. More... | |
| void | setMinimumSize (const QSizeF &size) |
| Sets the minimum size to size. More... | |
| void | setMinimumSize (qreal w, qreal h) |
| This convenience function is equivalent to calling setMinimumSize(QSizeF(w, h)). More... | |
| void | setMinimumWidth (qreal width) |
| Sets the minimum width to width. More... | |
| void | setParentLayoutItem (QGraphicsLayoutItem *parent) |
| Sets the parent of this QGraphicsLayoutItem to parent. More... | |
| void | setPreferredHeight (qreal height) |
| Sets the preferred height to height. More... | |
| void | setPreferredSize (const QSizeF &size) |
| Sets the preferred size to size. More... | |
| void | setPreferredSize (qreal w, qreal h) |
| This convenience function is equivalent to calling setPreferredSize(QSizeF(w, h)). More... | |
| void | setPreferredWidth (qreal width) |
| Sets the preferred width to width. More... | |
| void | setSizePolicy (const QSizePolicy &policy) |
| Sets the size policy to policy. More... | |
| void | setSizePolicy (QSizePolicy::Policy hPolicy, QSizePolicy::Policy vPolicy, QSizePolicy::ControlType controlType=QSizePolicy::DefaultType) |
| This function is equivalent to calling setSizePolicy(QSizePolicy(hPolicy, vPolicy, controlType)). More... | |
| QSizePolicy | sizePolicy () const |
| Returns the current size policy. More... | |
| virtual | ~QGraphicsLayoutItem () |
| Destroys the QGraphicsLayoutItem object. More... | |
Static Public Functions | |
| static void | setTabOrder (QGraphicsWidget *first, QGraphicsWidget *second) |
| Moves the second widget around the ring of focus widgets so that keyboard focus moves from the first widget to the second widget when the Tab key is pressed. More... | |
| Static Public Functions inherited from QObject | |
| static bool | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection) |
| Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More... | |
| static bool | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection) |
| static bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member) |
| Disconnects signal in object sender from method in object receiver. More... | |
| static bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member) |
| static uint | registerUserData () |
| static QString | tr (const char *sourceText, const char *comment=0, int n=-1) |
| static QString | trUtf8 (const char *sourceText, const char *comment=0, int n=-1) |
Protected Functions | |
| virtual void | changeEvent (QEvent *event) |
| This event handler can be reimplemented to handle state changes. More... | |
| virtual void | closeEvent (QCloseEvent *event) |
| This event handler, for event, can be reimplemented in a subclass to receive widget close events. More... | |
| bool | event (QEvent *event) |
| Handles the event. More... | |
| void | focusInEvent (QFocusEvent *event) |
| Reimplemented Function More... | |
| virtual bool | focusNextPrevChild (bool next) |
| Finds a new widget to give the keyboard focus to, as appropriate for Tab and Shift+Tab, and returns true if it can find a new widget; returns false otherwise. More... | |
| void | focusOutEvent (QFocusEvent *event) |
| Reimplemented Function More... | |
| virtual void | grabKeyboardEvent (QEvent *event) |
| This event handler, for event, can be reimplemented in a subclass to receive notifications for QEvent::GrabKeyboard events. More... | |
| virtual void | grabMouseEvent (QEvent *event) |
| This event handler, for event, can be reimplemented in a subclass to receive notifications for QEvent::GrabMouse events. More... | |
| virtual void | hideEvent (QHideEvent *event) |
| This event handler, for Hide events, is delivered after the widget has been hidden, for example, setVisible(false) has been called for the widget or one of its ancestors when the widget was previously shown. More... | |
| virtual void | hoverLeaveEvent (QGraphicsSceneHoverEvent *event) |
| Reimplemented Function More... | |
| virtual void | hoverMoveEvent (QGraphicsSceneHoverEvent *event) |
| Reimplemented Function More... | |
| virtual void | initStyleOption (QStyleOption *option) const |
| Populates a style option object for this widget based on its current state, and stores the output in option. More... | |
| QVariant | itemChange (GraphicsItemChange change, const QVariant &value) |
| QGraphicsWidget uses the base implementation of this function to catch and deliver events related to state changes in the item. More... | |
| virtual void | moveEvent (QGraphicsSceneMoveEvent *event) |
| This event handler, for GraphicsSceneMove events, is delivered after the widget has moved (e.g., its local position has changed). More... | |
| virtual void | polishEvent () |
| This event is delivered to the item by the scene at some point after it has been constructed, but before it is shown or otherwise accessed through the scene. More... | |
| virtual QVariant | propertyChange (const QString &propertyName, const QVariant &value) |
| This virtual function is used to notify changes to any property (both dynamic properties, and registered with e.g., "size";, and value is the (proposed) new value of the property. More... | |
| QGraphicsWidget (QGraphicsWidgetPrivate &, QGraphicsItem *parent, QGraphicsScene *, Qt::WindowFlags wFlags=0) | |
| Constructs a new QGraphicsWidget, using dd as parent. More... | |
| virtual void | resizeEvent (QGraphicsSceneResizeEvent *event) |
| This event handler, for GraphicsSceneResize events, is delivered after the widget has been resized (i.e., its local size has changed). More... | |
| bool | sceneEvent (QEvent *event) |
| QGraphicsWidget's implementation of sceneEvent() simply passes event to QGraphicsWidget::event(). More... | |
| virtual void | showEvent (QShowEvent *event) |
| This event handler, for Show events, is delivered before the widget has been shown, for example, setVisible(true) has been called for the widget or one of its ancestors when the widget was previously hidden. More... | |
| QSizeF | sizeHint (Qt::SizeHint which, const QSizeF &constraint=QSizeF()) const |
| Reimplemented Function More... | |
| virtual void | ungrabKeyboardEvent (QEvent *event) |
| This event handler, for event, can be reimplemented in a subclass to receive notifications for QEvent::UngrabKeyboard events. More... | |
| virtual void | ungrabMouseEvent (QEvent *event) |
| This event handler, for event, can be reimplemented in a subclass to receive notifications for QEvent::UngrabMouse events. More... | |
| void | updateGeometry () |
| If this widget is currently managed by a layout, this function notifies the layout that the widget's size hints have changed and the layout may need to resize and reposition the widget accordingly. More... | |
| virtual bool | windowFrameEvent (QEvent *e) |
| This event handler, for event, receives events for the window frame if this widget is a window. More... | |
| virtual Qt::WindowFrameSection | windowFrameSectionAt (const QPointF &pos) const |
| Returns the window frame section at position pos, or Qt::NoSection if there is no window frame section at this position. More... | |
| Protected Functions inherited from QGraphicsObject | |
| QGraphicsObject (QGraphicsItemPrivate &dd, QGraphicsItem *parent, QGraphicsScene *scene) | |
| Protected Functions inherited from QObject | |
| virtual void | childEvent (QChildEvent *) |
| This event handler can be reimplemented in a subclass to receive child events. More... | |
| virtual void | connectNotify (const char *signal) |
| This virtual function is called when something has been connected to signal in this object. More... | |
| virtual void | customEvent (QEvent *) |
| This event handler can be reimplemented in a subclass to receive custom events. More... | |
| virtual void | disconnectNotify (const char *signal) |
| This virtual function is called when something has been disconnected from signal in this object. More... | |
| QObject (QObjectPrivate &dd, QObject *parent=0) | |
| int | receivers (const char *signal) const |
| Returns the number of receivers connected to the signal. More... | |
| QObject * | sender () const |
| Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More... | |
| int | senderSignalIndex () const |
| virtual void | timerEvent (QTimerEvent *) |
| This event handler can be reimplemented in a subclass to receive timer events for the object. 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 | hoverEnterEvent (QGraphicsSceneHoverEvent *event) |
| This event handler, for event event, can be reimplemented to receive hover enter 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 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 | 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 Functions inherited from QGraphicsLayoutItem | |
| QGraphicsLayoutItem (QGraphicsLayoutItemPrivate &dd) | |
| void | setGraphicsItem (QGraphicsItem *item) |
| If the QGraphicsLayoutItem represents a QGraphicsItem, and it wants to take advantage of the automatic reparenting capabilities of QGraphicsLayout it should set this value. More... | |
| void | setOwnedByLayout (bool ownedByLayout) |
| Sets whether a layout should delete this item in its destructor or not. More... | |
Properties | |
| bool | autoFillBackground |
| whether the widget background is filled automatically More... | |
| Qt::FocusPolicy | focusPolicy |
| the way the widget accepts keyboard focus More... | |
| QFont | font |
| the widgets' font More... | |
| QRectF | geometry |
| the geometry of the widget More... | |
| QGraphicsLayout * | layout |
| The layout of the widget. More... | |
| Qt::LayoutDirection | layoutDirection |
| the layout direction for this widget. More... | |
| QSizeF | maximumSize |
| the maximum size of the widget More... | |
| QSizeF | minimumSize |
| the minimum size of the widget More... | |
| QPalette | palette |
| the widget's palette More... | |
| QSizeF | preferredSize |
| the preferred size of the widget More... | |
| QSizeF | size |
| the size of the widget More... | |
| QSizePolicy | sizePolicy |
| the size policy for the widget More... | |
| Qt::WindowFlags | windowFlags |
| the widget's window flags More... | |
| QString | windowTitle |
| This property holds the window title (caption). More... | |
Friends | |
| class | QApplication |
| class | QGraphicsItem |
| class | QGraphicsItemPrivate |
| class | QGraphicsLayout |
| class | QGraphicsScene |
| class | QGraphicsScenePrivate |
| class | QGraphicsView |
| class | QWidget |
Additional Inherited Members | |
| Static Public Variables inherited from QObject | |
| static const QMetaObject | staticMetaObject |
| This variable stores the meta-object for the class. More... | |
| 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 Slots inherited from QGraphicsObject | |
| void | updateMicroFocus () |
| Updates the item's micro focus. More... | |
| Protected Variables inherited from QObject | |
| QScopedPointer< QObjectData > | d_ptr |
| Protected Variables inherited from QGraphicsItem | |
| QScopedPointer< QGraphicsItemPrivate > | d_ptr |
| Protected Variables inherited from QGraphicsLayoutItem | |
| QScopedPointer< QGraphicsLayoutItemPrivate > | d_ptr |
| Static Protected Variables inherited from QObject | |
| static const QMetaObject | staticQtMetaObject |
| Related Functions inherited from QObject | |
| T | qFindChildqFindChildren (const QObject *obj, const QString &name)() |
| QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QString &name)() |
| QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QRegExp ®Exp)() |
| T * | qobject_cast (QObject *object) |
| QObjectList | |
| void * | qt_find_obj_child (QObject *parent, const char *type, const QString &name) |
| Returns a pointer to the object named name that inherits type and with a given parent. More... | |
| Related Functions inherited from QGraphicsItem | |
| T | qgraphicsitem_cast (QGraphicsItem *item) |
The QGraphicsWidget class is the base class for all widget items in a QGraphicsScene.
QGraphicsWidget is an extended base item that provides extra functionality over QGraphicsItem. It is similar to QWidget in many ways:
Unlike QGraphicsItem, QGraphicsWidget is not an abstract class; you can create instances of a QGraphicsWidget without having to subclass it. This approach is useful for widgets that only serve the purpose of organizing child widgets into a layout.
QGraphicsWidget can be used as a base item for your own custom item if you require advanced input focus handling, e.g., tab focus and activation, or layouts.
Since QGraphicsWidget resembles QWidget and has similar API, it is easier to port a widget from QWidget to QGraphicsWidget, instead of QGraphicsItem.
Noticeable differences between QGraphicsWidget and QWidget are:
| QGraphicsWidget | QWidget |
| Coordinates and geometry are defined with qreals (doubles or floats, depending on the platform). | QWidget uses integer geometry (QPoint, QRect). |
| The widget is already visible by default; you do not have to call show() to display the widget. | QWidget is hidden by default until you call show(). |
| A subset of widget attributes are supported. | All widget attributes are supported. |
| A top-level item's style defaults to QGraphicsScene::style | A top-level widget's style defaults to QApplication::style |
| Graphics View provides a custom drag and drop framework, different from QWidget. | Standard drag and drop framework. |
| Widget items do not support modality. | Full modality support. |
QGraphicsWidget supports a subset of Qt's widget attributes, (Qt::WidgetAttribute), as shown in the table below. Any attributes not listed in this table are unsupported, or otherwise unused.
| Widget Attribute | Usage |
| Qt::WA_SetLayoutDirection | Set by setLayoutDirection(), cleared by unsetLayoutDirection(). You can test this attribute to check if the widget has been explicitly assigned a layoutDirection. If the attribute is not set, the layoutDirection() is inherited. |
| Qt::WA_RightToLeft | Toggled by setLayoutDirection(). Inherited from the parent/scene. If set, the widget's layout will order horizontally arranged widgets from right to left. |
| Qt::WA_SetStyle | Set and cleared by setStyle(). If this attribute is set, the widget has been explicitly assigned a style. If it is unset, the widget will use the scene's or the application's style. |
| Qt::WA_Resized | Set by setGeometry() and resize(). |
| Qt::WA_SetPalette | Set by setPalette(). |
| Qt::WA_SetFont | Set by setFont(). |
| Qt::WA_WindowPropagation | Enables propagation to window widgets. |
Although QGraphicsWidget inherits from both QObject and QGraphicsItem, you should use the functions provided by QGraphicsItem, not QObject, to manage the relationships between parent and child items. These functions control the stacking order of items as well as their ownership.
Definition at line 69 of file qgraphicswidget.h.
| anonymous enum |
| Enumerator | |
|---|---|
| Type | |
Definition at line 161 of file qgraphicswidget.h.
| QGraphicsWidget::QGraphicsWidget | ( | QGraphicsItem * | parent = 0, |
| Qt::WindowFlags | wFlags = 0 |
||
| ) |
Constructs a QGraphicsWidget instance.
The optional parent argument is passed to QGraphicsItem's constructor. The optional wFlags argument specifies the widget's window flags (e.g., whether the widget should be a window, a tool, a popup, etc).
Definition at line 178 of file qgraphicswidget.cpp.
| QGraphicsWidget::~QGraphicsWidget | ( | ) |
Destroys the QGraphicsWidget instance.
Definition at line 236 of file qgraphicswidget.cpp.
|
protected |
Constructs a new QGraphicsWidget, using dd as parent.
Definition at line 193 of file qgraphicswidget.cpp.
Returns the (possibly empty) list of this widget's actions.
Definition at line 2177 of file qgraphicswidget.cpp.
| void QGraphicsWidget::addAction | ( | QAction * | action | ) |
Appends the action action to this widget's list of actions.
All QGraphicsWidgets have a list of QAction, however they can be represented graphically in many different ways. The default use of the QAction list (as returned by actions()) is to create a context QMenu.
A QGraphicsWidget should only have one of each action and adding an action it already has will not cause the same action to be in the widget twice.
Definition at line 2056 of file qgraphicswidget.cpp.
Appends the actions actions to this widget's list of actions.
Definition at line 2071 of file qgraphicswidget.cpp.
| void QGraphicsWidget::adjustSize | ( | ) |
Adjusts the size of the widget to its effective preferred size hint.
This function is called implicitly when the item is shown for the first time.
Definition at line 892 of file qgraphicswidget.cpp.
Referenced by itemChange().
| bool QGraphicsWidget::autoFillBackground | ( | ) | const |
Referenced by setPalette().
|
virtual |
Reimplemented Function
Implements QGraphicsItem.
Definition at line 2437 of file qgraphicswidget.cpp.
|
protectedvirtual |
This event handler can be reimplemented to handle state changes.
The state being changed in this event can be retrieved through event.
Change events include: QEvent::ActivationChange, QEvent::EnabledChange, QEvent::FontChange, QEvent::StyleChange, QEvent::PaletteChange, QEvent::ParentChange, QEvent::LayoutDirectionChange, and QEvent::ContentsRectChange.
Definition at line 1526 of file qgraphicswidget.cpp.
Referenced by event().
|
slot |
Call this function to close the widget.
Returns true if the widget was closed; otherwise returns false. This slot will first send a QCloseEvent to the widget, which may or may not accept the event. If the event was ignored, nothing happens. If the event was accepted, it will hide() the widget.
If the widget has the Qt::WA_DeleteOnClose attribute set it will be deleted.
Definition at line 2463 of file qgraphicswidget.cpp.
Referenced by QGraphicsItem::mousePressEvent().
|
protectedvirtual |
This event handler, for event, can be reimplemented in a subclass to receive widget close events.
The default implementation accepts the event.
Definition at line 1558 of file qgraphicswidget.cpp.
|
protectedvirtual |
Handles the event.
Reimplemented Function
QGraphicsWidget handles the following events:
Event
Usage
Polish
Delivered to the widget some time after it has been shown.
GraphicsSceneMove
Delivered to the widget after its local position has changed.
GraphicsSceneResize
Delivered to the widget after its size has changed.
Show
Delivered to the widget before it has been shown.
Hide
Delivered to the widget after it has been hidden.
PaletteChange
Delivered to the widget after its palette has changed.
FontChange
Delivered to the widget after its font has changed.
EnabledChange
Delivered to the widget after its enabled state has changed.
StyleChange
Delivered to the widget after its style has changed.
LayoutDirectionChange
Delivered to the widget after its layout direction has changed.
ContentsRectChange
Delivered to the widget after its contents margins/ contents rect has changed.
Reimplemented from QObject.
Definition at line 1432 of file qgraphicswidget.cpp.
Referenced by QGraphicsProxyWidget::event(), itemChange(), setGeometry(), and setStyle().
|
protectedvirtual |
Reimplemented Function
Reimplemented from QGraphicsItem.
Definition at line 1566 of file qgraphicswidget.cpp.
|
protectedvirtual |
Finds a new widget to give the keyboard focus to, as appropriate for Tab and Shift+Tab, and returns true if it can find a new widget; returns false otherwise.
If next is true, this function searches forward; if next is false, it searches backward.
Sometimes, you will want to reimplement this function to provide special focus handling for your widget and its subwidgets. For example, a web browser might reimplement it to move its current active link forward or backward, and call the base implementation only when it reaches the last or first link on the page.
Child widgets call focusNextPrevChild() on their parent widgets, but only the window that contains the child widgets decides where to redirect focus. By reimplementing this function for an object, you gain control of focus traversal for all child widgets.
Reimplemented in QGraphicsProxyWidget.
Definition at line 1592 of file qgraphicswidget.cpp.
Referenced by QGraphicsProxyWidget::focusNextPrevChild(), and focusNextPrevChild().
|
protectedvirtual |
Reimplemented Function
Reimplemented from QGraphicsItem.
Definition at line 1614 of file qgraphicswidget.cpp.
| Qt::FocusPolicy QGraphicsWidget::focusPolicy | ( | ) | const |
Referenced by focusInEvent(), focusOutEvent(), and setWindowTitle().
| QGraphicsWidget * QGraphicsWidget::focusWidget | ( | ) | const |
If this widget, a child or descendant of this widget currently has input focus, this function will return a pointer to that widget.
If no descendant widget has input focus, 0 is returned.
Definition at line 1920 of file qgraphicswidget.cpp.
Referenced by QGraphicsScenePrivate::addPopup(), QGraphicsProxyWidget::event(), QGraphicsProxyWidget::focusOutEvent(), and QGraphicsProxyWidget::wheelEvent().
| QFont QGraphicsWidget::font | ( | ) | const |
Referenced by initStyleOption(), setStyle(), and QWidgetPrivate::updateFont().
|
signal |
This signal gets emitted whenever the geometry is changed in setGeometry().
Referenced by setGeometry().
|
virtual |
Gets the widget's contents margins.
The margins are stored in left, top, right and bottom, as pointers to qreals. Each argument can be {omitted} by passing 0.
Reimplemented from QGraphicsLayoutItem.
Definition at line 546 of file qgraphicswidget.cpp.
| void QGraphicsWidget::getWindowFrameMargins | ( | qreal * | left, |
| qreal * | top, | ||
| qreal * | right, | ||
| qreal * | bottom | ||
| ) | const |
Gets the widget's window frame margins.
The margins are stored in left, top, right and bottom as pointers to qreals. Each argument can be {omitted} by passing 0.
Definition at line 601 of file qgraphicswidget.cpp.
|
protectedvirtual |
This event handler, for event, can be reimplemented in a subclass to receive notifications for QEvent::GrabKeyboard events.
Definition at line 1755 of file qgraphicswidget.cpp.
Referenced by event().
|
protectedvirtual |
This event handler, for event, can be reimplemented in a subclass to receive notifications for QEvent::GrabMouse events.
Reimplemented in QGraphicsProxyWidget.
Definition at line 1733 of file qgraphicswidget.cpp.
Referenced by event().
| int QGraphicsWidget::grabShortcut | ( | const QKeySequence & | sequence, |
| Qt::ShortcutContext | context = Qt::WindowShortcut |
||
| ) |
Adds a shortcut to Qt's shortcut system that watches for the given key sequence in the given context.
If the context is Qt::ApplicationShortcut, the shortcut applies to the application as a whole. Otherwise, it is either local to this widget, Qt::WidgetShortcut, or to the window itself, Qt::WindowShortcut. For widgets that are not part of a window (i.e., top-level widgets and their children), Qt::WindowShortcut shortcuts apply to the scene.
If the same key sequence has been grabbed by several widgets, when the key sequence occurs a QEvent::Shortcut event is sent to all the widgets to which it applies in a non-deterministic order, but with the ``ambiguous'' flag set to true.
Definition at line 1959 of file qgraphicswidget.cpp.
|
protectedvirtual |
This event handler, for Hide events, is delivered after the widget has been hidden, for example, setVisible(false) has been called for the widget or one of its ancestors when the widget was previously shown.
You can reimplement this event handler to detect when your widget is hidden. Calling QEvent::accept() or QEvent::ignore() on event has no effect.
Reimplemented in QGraphicsProxyWidget.
Definition at line 1633 of file qgraphicswidget.cpp.
Referenced by event().
|
protectedvirtual |
Reimplemented Function
Reimplemented from QGraphicsItem.
Reimplemented in QGraphicsProxyWidget.
Definition at line 1722 of file qgraphicswidget.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QGraphicsItem.
Reimplemented in QGraphicsProxyWidget.
Definition at line 1714 of file qgraphicswidget.cpp.
|
protectedvirtual |
Populates a style option object for this widget based on its current state, and stores the output in option.
The default implementation populates option with the following properties.
| Style Option Property | Value |
| state & QStyle::State_Enabled | Corresponds to QGraphicsItem::isEnabled(). |
| state & QStyle::State_HasFocus | Corresponds to QGraphicsItem::hasFocus(). |
| state & QStyle::State_MouseOver | Corresponds to QGraphicsItem::isUnderMouse(). |
| direction | Corresponds to QGraphicsWidget::layoutDirection(). |
| rect | Corresponds to QGraphicsWidget::rect().toRect(). |
| palette | Corresponds to QGraphicsWidget::palette(). |
| fontMetrics | Corresponds to QFontMetrics(QGraphicsWidget::font()). |
Subclasses of QGraphicsWidget should call the base implementation, and then test the type of option using qstyleoption_cast<>() or test QStyleOption::Type before storing widget-specific options.
For example:
Definition at line 709 of file qgraphicswidget.cpp.
Referenced by paintWindowFrame().
Inserts the action action to this widget's list of actions, before the action before.
It appends the action if before is 0 or before is not a valid action for this widget.
A QGraphicsWidget should only have one of each action.
Definition at line 2092 of file qgraphicswidget.cpp.
Referenced by addAction(), addActions(), and insertActions().
Inserts the actions actions to this widget's list of actions, before the action before.
It appends the action if before is 0 or before is not a valid action for this widget.
A QGraphicsWidget can have at most one of each action.
Definition at line 2134 of file qgraphicswidget.cpp.
| bool QGraphicsWidget::isActiveWindow | ( | ) | const |
Returns true if this widget's window is in the active window, or if the widget does not have a window but is in an active scene (i.e., a scene that currently has focus).
The active window is the window that either contains a child widget that currently has input focus, or that itself has input focus.
Definition at line 1845 of file qgraphicswidget.cpp.
Referenced by initStyleOption(), and paintWindowFrame().
|
protectedvirtual |
QGraphicsWidget uses the base implementation of this function to catch and deliver events related to state changes in the item.
Reimplemented Function
Because of this, it is very important that subclasses call the base implementation.
change specifies the type of change, and value is the new value.
For example, QGraphicsWidget uses ItemVisibleChange to deliver Show and Hide events, ItemPositionHasChanged to deliver Move events, and ItemParentChange both to deliver ParentChange events, and for managing the focus chain.
QGraphicsWidget enables the ItemSendsGeometryChanges flag by default in order to track position changes.
Reimplemented from QGraphicsItem.
Definition at line 1171 of file qgraphicswidget.cpp.
Referenced by QGraphicsProxyWidget::itemChange().
| QGraphicsLayout* QGraphicsWidget::layout | ( | ) | const |
Referenced by sizeHint().
|
signal |
This signal gets emitted whenever the layout of the item changes.
Referenced by setLayout().
| Qt::LayoutDirection QGraphicsWidget::layoutDirection | ( | ) | const |
Referenced by adjustSize(), and initStyleOption().
|
protectedvirtual |
This event handler, for GraphicsSceneMove events, is delivered after the widget has moved (e.g., its local position has changed).
This event is only delivered when the item is moved locally. Calling setTransform() or moving any of the item's ancestors does not affect the item's local position.
You can reimplement this event handler to detect when your widget has moved. Calling QEvent::accept() or QEvent::ignore() on event has no effect.
Definition at line 1655 of file qgraphicswidget.cpp.
Referenced by event().
|
virtual |
Reimplemented Function
Implements QGraphicsItem.
Definition at line 2305 of file qgraphicswidget.cpp.
Referenced by _q_paintItem().
|
virtual |
This virtual function is called by QGraphicsScene to draw the window frame for windows using painter, option, and widget, in local coordinates.
The base implementation uses the current style to render the frame and title bar.
You can reimplement this function in a subclass of QGraphicsWidget to provide custom rendering of the widget's window frame.
Definition at line 2323 of file qgraphicswidget.cpp.
Referenced by _q_paintItem().
| QPalette QGraphicsWidget::palette | ( | ) | const |
Referenced by initStyleOption(), paintWindowFrame(), QWidgetPrivate::propagatePaletteChange(), and setFont().
|
protectedvirtual |
This event is delivered to the item by the scene at some point after it has been constructed, but before it is shown or otherwise accessed through the scene.
You can use this event handler to do last-minute initializations of the widget which require the item to be fully constructed.
The base implementation does nothing.
Definition at line 1669 of file qgraphicswidget.cpp.
Referenced by event().
|
protectedvirtual |
This virtual function is used to notify changes to any property (both dynamic properties, and registered with e.g., "size";, and value is the (proposed) new value of the property.
The function returns the new value, which may be different from value if the notification supports adjusting the property value. The base implementation simply returns value for any propertyName.
QGraphicsWidget delivers notifications for the following properties:
propertyName
Property
layoutDirection
QGraphicsWidget::layoutDirection
size
font
palette
Definition at line 1259 of file qgraphicswidget.cpp.
|
inline |
Returns the item's local rect as a QRectF.
This function is equivalent to QRectF(QPointF(), size()).
Definition at line 116 of file qgraphicswidget.h.
Referenced by QGraphicsProxyWidget::hoverMoveEvent(), initStyleOption(), QGraphicsItem::mousePressEvent(), QGraphicsProxyWidget::paint(), paintWindowFrame(), setGeometry(), shape(), and windowFrameRect().
| void QGraphicsWidget::releaseShortcut | ( | int | id | ) |
Removes the shortcut with the given id from Qt's shortcut system.
The widget will no longer receive QEvent::Shortcut events for the shortcut's key sequence (unless it has other shortcuts with the same key sequence).
Definition at line 1988 of file qgraphicswidget.cpp.
| void QGraphicsWidget::removeAction | ( | QAction * | action | ) |
Removes the action action from this widget's list of actions.
Definition at line 2150 of file qgraphicswidget.cpp.
Referenced by QAction::~QAction().
| void QGraphicsWidget::resize | ( | const QSizeF & | size | ) |
Definition at line 314 of file qgraphicswidget.cpp.
Referenced by QDeclarativeLoaderPrivate::_q_updateSize(), adjustSize(), and updateGeometry().
This convenience function is equivalent to calling resize(QSizeF(w, h)).
Definition at line 111 of file qgraphicswidget.h.
Referenced by resize().
|
protectedvirtual |
This event handler, for GraphicsSceneResize events, is delivered after the widget has been resized (i.e., its local size has changed).
event contains both the old and the new size.
This event is only delivered when the widget is resized locally; calling setTransform() on the widget or any of its ancestors or view, does not affect the widget's local size.
You can reimplement this event handler to detect when your widget has been resized. Calling QEvent::accept() or QEvent::ignore() on event has no effect.
Reimplemented in QGraphicsProxyWidget.
Definition at line 1689 of file qgraphicswidget.cpp.
Referenced by event(), and QGraphicsProxyWidget::resizeEvent().
|
protectedvirtual |
QGraphicsWidget's implementation of sceneEvent() simply passes event to QGraphicsWidget::event().
You can handle all events for your widget in event() or in any of the convenience functions; you should not have to reimplement this function in a subclass of QGraphicsWidget.
Reimplemented from QGraphicsItem.
Definition at line 1273 of file qgraphicswidget.cpp.
| void QGraphicsWidget::setAttribute | ( | Qt::WidgetAttribute | attribute, |
| bool | on = true |
||
| ) |
If on is true, this function enables attribute; otherwise attribute is disabled.
See the class documentation for QGraphicsWidget for a complete list of which attributes are supported, and what they are for.
Definition at line 2273 of file qgraphicswidget.cpp.
Referenced by itemChange(), setFont(), setGeometry(), setLayoutDirection(), setPalette(), setStyle(), unsetLayoutDirection(), and updateGeometry().
| void QGraphicsWidget::setAutoFillBackground | ( | bool | enabled | ) |
Definition at line 1094 of file qgraphicswidget.cpp.
Sets the widget's contents margins to left, top, right and bottom.
Contents margins are used by the assigned layout to define the placement of subwidgets and layouts. Margins are particularly useful for widgets that constrain subwidgets to only a section of its own geometry. For example, a group box with a layout will place subwidgets inside its frame, but below the title.
Changing a widget's contents margins will always trigger an update(), and any assigned layout will be activated automatically. The widget will then receive a ContentsRectChange event.
Definition at line 512 of file qgraphicswidget.cpp.
| void QGraphicsWidget::setFocusPolicy | ( | Qt::FocusPolicy | policy | ) |
Definition at line 1902 of file qgraphicswidget.cpp.
| void QGraphicsWidget::setFont | ( | const QFont & | font | ) |
Definition at line 1017 of file qgraphicswidget.cpp.
|
virtual |
This virtual function sets the geometry of the QGraphicsLayoutItem to rect, which is in parent coordinates (e.
g., the top-left corner of rect is equivalent to the item's position in parent coordinates).
You must reimplement this function in a subclass of QGraphicsLayoutItem to receive geometry updates. The layout will call this function when it does a rearrangement.
If rect is outside of the bounds of minimumSize and maximumSize, it will be adjusted to its closest size so that it is within the legal bounds.
Reimplemented from QGraphicsLayoutItem.
Definition at line 365 of file qgraphicswidget.cpp.
Referenced by resize(), and QGraphicsProxyWidget::setGeometry().
This convenience function is equivalent to calling setGeometry(QRectF( x, y, w, h)).
Definition at line 249 of file qgraphicswidget.h.
| void QGraphicsWidget::setLayout | ( | QGraphicsLayout * | layout | ) |
Sets the layout for this widget to layout.
Any existing layout manager is deleted before the new layout is assigned. If layout is 0, the widget is left without a layout. Existing subwidgets' geometries will remain unaffected.
All widgets that are currently managed by layout or all of its sublayouts, are automatically reparented to this item. The layout is then invalidated, and the child widget geometries are adjusted according to this item's geometry() and contentsMargins(). Children who are not explicitly managed by layout remain unaffected by the layout after it has been assigned to this widget.
QGraphicsWidget takes ownership of layout.
Definition at line 859 of file qgraphicswidget.cpp.
| void QGraphicsWidget::setLayoutDirection | ( | Qt::LayoutDirection | direction | ) |
Definition at line 933 of file qgraphicswidget.cpp.
| void QGraphicsWidget::setPalette | ( | const QPalette & | palette | ) |
Definition at line 1060 of file qgraphicswidget.cpp.
| void QGraphicsWidget::setShortcutAutoRepeat | ( | int | id, |
| bool | enabled = true |
||
| ) |
If enabled is true, auto repeat of the shortcut with the given id is enabled; otherwise it is disabled.
Definition at line 2030 of file qgraphicswidget.cpp.
| void QGraphicsWidget::setShortcutEnabled | ( | int | id, |
| bool | enabled = true |
||
| ) |
If enabled is true, the shortcut with the given id is enabled; otherwise the shortcut is disabled.
Definition at line 2012 of file qgraphicswidget.cpp.
| void QGraphicsWidget::setStyle | ( | QStyle * | style | ) |
Sets the widget's style to style.
QGraphicsWidget does not take ownership of style.
If no style is assigned, or style is 0, the widget will use QGraphicsScene::style() (if this has been set). Otherwise the widget will use QApplication::style().
This function sets the Qt::WA_SetStyle attribute if style is not 0; otherwise it clears the attribute.
Definition at line 975 of file qgraphicswidget.cpp.
Referenced by QGraphicsProxyWidget::eventFilter().
|
static |
Moves the second widget around the ring of focus widgets so that keyboard focus moves from the first widget to the second widget when the Tab key is pressed.
Note that since the tab order of the second widget is changed, you should order a chain like this:
not like this:
If first is 0, this indicates that second should be the first widget to receive input focus should the scene gain Tab focus (i.e., the user hits Tab so that focus passes into the scene). If second is 0, this indicates that first should be the first widget to gain focus if the scene gained BackTab focus.
By default, tab order is defined implicitly using widget creation order.
Definition at line 2208 of file qgraphicswidget.cpp.
| void QGraphicsWidget::setWindowFlags | ( | Qt::WindowFlags | wFlags | ) |
Definition at line 1806 of file qgraphicswidget.cpp.
Sets the widget's window frame margins to left, top, right and bottom.
The default frame margins are provided by the style, and they depend on the current window flags.
If you would like to draw your own window decoration, you can set your own frame margins to override the default margins.
Definition at line 571 of file qgraphicswidget.cpp.
Referenced by unsetWindowFrameMargins().
| void QGraphicsWidget::setWindowTitle | ( | const QString & | title | ) |
Definition at line 1862 of file qgraphicswidget.cpp.
|
virtual |
Reimplemented Function
Reimplemented from QGraphicsItem.
Definition at line 2445 of file qgraphicswidget.cpp.
|
protectedvirtual |
This event handler, for Show events, is delivered before the widget has been shown, for example, setVisible(true) has been called for the widget or one of its ancestors when the widget was previously hidden.
You can reimplement this event handler to detect when your widget is shown. Calling QEvent::accept() or QEvent::ignore() on event has no effect.
Reimplemented in QGraphicsProxyWidget.
Definition at line 1706 of file qgraphicswidget.cpp.
Referenced by event().
| QSizeF QGraphicsWidget::size | ( | ) | const |
Referenced by paintWindowFrame(), setGeometry(), updateGeometry(), and ~QGraphicsWidget().
|
protectedvirtual |
Reimplemented Function
Implements QGraphicsLayoutItem.
Definition at line 767 of file qgraphicswidget.cpp.
Referenced by QGraphicsProxyWidget::sizeHint().
| QStyle * QGraphicsWidget::style | ( | ) | const |
Returns a pointer to the widget's style.
If this widget does not have any explicitly assigned style, the scene's style is returned instead. In turn, if the scene does not have any assigned style, this function returns QApplication::style().
Definition at line 954 of file qgraphicswidget.cpp.
Referenced by QGraphicsProxyWidget::event(), paintWindowFrame(), QGraphicsWidgetStyles::setStyleForWidget(), QGraphicsAnchorLayoutPrivate::styleInfo(), and unsetWindowFrameMargins().
| bool QGraphicsWidget::testAttribute | ( | Qt::WidgetAttribute | attribute | ) | const |
Returns true if attribute is enabled for this widget; otherwise, returns false.
Definition at line 2288 of file qgraphicswidget.cpp.
Referenced by adjustSize(), close(), itemChange(), paintWindowFrame(), QGraphicsWidgetPrivate::setLayoutDirection_helper(), QGraphicsScene::setStyle(), QGraphicsWidgetPrivate::updateFont(), updateGeometry(), and QGraphicsWidgetPrivate::updatePalette().
|
virtual |
Reimplemented Function
Reimplemented from QGraphicsItem.
Definition at line 2297 of file qgraphicswidget.cpp.
|
protectedvirtual |
This event handler, for event, can be reimplemented in a subclass to receive notifications for QEvent::UngrabKeyboard events.
Definition at line 1766 of file qgraphicswidget.cpp.
Referenced by event().
|
protectedvirtual |
This event handler, for event, can be reimplemented in a subclass to receive notifications for QEvent::UngrabMouse events.
Reimplemented in QGraphicsProxyWidget.
Definition at line 1744 of file qgraphicswidget.cpp.
Referenced by event().
| void QGraphicsWidget::unsetLayoutDirection | ( | ) |
Definition at line 939 of file qgraphicswidget.cpp.
| void QGraphicsWidget::unsetWindowFrameMargins | ( | ) |
Resets the window frame margins to the default value, provided by the style.
Definition at line 621 of file qgraphicswidget.cpp.
Referenced by changeEvent(), and setWindowFlags().
|
protectedvirtual |
If this widget is currently managed by a layout, this function notifies the layout that the widget's size hints have changed and the layout may need to resize and reposition the widget accordingly.
Call this function if the widget's sizeHint() has changed.
If this is the topmost widget, post a LayoutRequest event to the widget. When the event is received, it will start flowing all the way down to the leaf widgets in one go. This will make a relayout flicker-free.
Reimplemented from QGraphicsLayoutItem.
Definition at line 1112 of file qgraphicswidget.cpp.
Referenced by changeEvent(), QGraphicsProxyWidget::eventFilter(), and setContentsMargins().
| Qt::WindowFlags QGraphicsWidget::windowFlags | ( | ) | const |
Referenced by windowType().
|
protectedvirtual |
This event handler, for event, receives events for the window frame if this widget is a window.
Its base implementation provides support for default window frame interaction such as moving, resizing, etc.
You can reimplement this handler in a subclass of QGraphicsWidget to provide your own custom window frame interaction support.
Returns true if event has been recognized and processed; otherwise, returns false.
Definition at line 1291 of file qgraphicswidget.cpp.
Referenced by event().
| QRectF QGraphicsWidget::windowFrameGeometry | ( | ) | const |
Returns the widget's geometry in parent coordinates including any window frame.
Definition at line 644 of file qgraphicswidget.cpp.
Referenced by paintWindowFrame().
| QRectF QGraphicsWidget::windowFrameRect | ( | ) | const |
Returns the widget's local rect including any window frame.
Definition at line 658 of file qgraphicswidget.cpp.
Referenced by boundingRect(), QGraphicsSceneIndexPrivate::itemCollidesWithPath(), paintWindowFrame(), and windowFrameSectionAt().
|
protectedvirtual |
Returns the window frame section at position pos, or Qt::NoSection if there is no window frame section at this position.
This function is used in QGraphicsWidget's base implementation for window frame interaction.
You can reimplement this function if you want to customize how a window can be interactively moved or resized. For instance, if you only want to allow a window to be resized by the bottom right corner, you can reimplement this function to return Qt::NoSection for all sections except Qt::BottomRightSection.
Definition at line 1341 of file qgraphicswidget.cpp.
| QString QGraphicsWidget::windowTitle | ( | ) | const |
Referenced by setWindowTitle().
| Qt::WindowType QGraphicsWidget::windowType | ( | ) | const |
Returns the widgets window type.
Definition at line 1776 of file qgraphicswidget.cpp.
Referenced by _q_paintItem(), QShortcutMap::correctGraphicsWidgetContext(), and QGraphicsItemPrivate::setVisibleHelper().
|
friend |
Definition at line 246 of file qgraphicswidget.h.
|
friend |
Definition at line 242 of file qgraphicswidget.h.
|
friend |
Definition at line 243 of file qgraphicswidget.h.
|
friend |
Definition at line 244 of file qgraphicswidget.h.
|
friend |
Definition at line 239 of file qgraphicswidget.h.
|
friend |
Definition at line 240 of file qgraphicswidget.h.
|
friend |
Definition at line 241 of file qgraphicswidget.h.
Definition at line 245 of file qgraphicswidget.h.
|
private |
whether the widget background is filled automatically
If enabled, this property will cause Qt to fill the background of the widget before invoking the paint() method. The color used is defined by the QPalette::Window color role from the widget's palette.
In addition, Windows are always filled with QPalette::Window, unless the WA_OpaquePaintEvent or WA_NoSystemBackground attributes are set.
By default, this property is false.
Definition at line 85 of file qgraphicswidget.h.
Referenced by _q_paintItem().
|
private |
the way the widget accepts keyboard focus
The focus policy is Qt::TabFocus if the widget accepts keyboard focus by tabbing, Qt::ClickFocus if the widget accepts focus by clicking, Qt::StrongFocus if it accepts both, and Qt::NoFocus (the default) if it does not accept focus at all.
You must enable keyboard focus for a widget if it processes keyboard events. This is normally done from the widget's constructor. For instance, the QLineEdit constructor calls setFocusPolicy(Qt::StrongFocus).
If you enable a focus policy (i.e., not Qt::NoFocus), QGraphicsWidget will automatically enable the ItemIsFocusable flag. Setting Qt::NoFocus on a widget will clear the ItemIsFocusable flag. If the widget currently has keyboard focus, the widget will automatically lose focus.
Definition at line 81 of file qgraphicswidget.h.
Referenced by QGraphicsScene::focusNextPrevChild().
|
private |
the widgets' font
This property provides the widget's font.
QFont consists of font properties that have been explicitly defined and properties implicitly inherited from the widget's parent. Hence, font() can return a different font compared to the one set with setFont(). This scheme allows you to define single entries in a font without affecting the font's inherited entries.
When a widget's font changes, it resolves its entries against its parent widget. If the widget does not have a parent widget, it resolves its entries against the scene. The widget then sends itself a FontChange event and notifies all its descendants so that they can resolve their fonts as well.
By default, this property contains the application's default font.
Definition at line 74 of file qgraphicswidget.h.
|
private |
the geometry of the widget
Sets the item's geometry to rect. The item's position and size are modified as a result of calling this function. The item is first moved, then resized.
A side effect of calling this function is that the widget will receive a move event and a resize event. Also, if the widget has a layout assigned, the layout will activate.
Definition at line 84 of file qgraphicswidget.h.
|
private |
The layout of the widget.
Returns this widget's layout, or 0 if no layout is currently managing this widget.
Any existing layout manager is deleted before the new layout is assigned. If layout is 0, the widget is left without a layout. Existing subwidgets' geometries will remain unaffected.
QGraphicsWidget takes ownership of layout.
All widgets that are currently managed by layout or all of its sublayouts, are automatically reparented to this item. The layout is then invalidated, and the child widget geometries are adjusted according to this item's geometry() and contentsMargins(). Children who are not explicitly managed by layout remain unaffected by the layout after it has been assigned to this widget.
If no layout is currently managing this widget, layout() will return 0.
Definition at line 86 of file qgraphicswidget.h.
Referenced by QGraphicsLayoutItemPrivate::hasHeightForWidth(), and QGraphicsLayoutItemPrivate::hasWidthForHeight().
|
private |
the layout direction for this widget.
This property modifies this widget's and all of its descendants' Qt::WA_RightToLeft attribute. It also sets this widget's Qt::WA_SetLayoutDirection attribute.
The widget's layout direction determines the order in which the layout manager horizontally arranges subwidgets of this widget. The default value depends on the language and locale of the application, and is typically in the same direction as words are read and written. With Qt::LeftToRight, the layout starts placing subwidgets from the left side of this widget towards the right. Qt::RightToLeft does the opposite - the layout will place widgets starting from the right edge moving towards the left.
Subwidgets inherit their layout direction from the parent. Top-level widget items inherit their layout direction from QGraphicsScene::layoutDirection. If you change a widget's layout direction by calling setLayoutDirection(), the widget will send itself a LayoutDirectionChange event, and then propagate the new layout direction to all its descendants.
Definition at line 75 of file qgraphicswidget.h.
Referenced by _q_paintItem().
|
private |
the maximum size of the widget
Definition at line 79 of file qgraphicswidget.h.
|
private |
the minimum size of the widget
Definition at line 77 of file qgraphicswidget.h.
|
private |
the widget's palette
This property provides the widget's palette. The palette provides colors and brushes for color groups (e.g., QPalette::Button) and states (e.g., QPalette::Inactive), loosely defining the general look of the widget and its children.
QPalette consists of color groups that have been explicitly defined, and groups that are implicitly inherited from the widget's parent. Because of this, palette() can return a different palette than what has been set with setPalette(). This scheme allows you to define single entries in a palette without affecting the palette's inherited entries.
When a widget's palette changes, it resolves its entries against its parent widget, or if it doesn't have a parent widget, it resolves against the scene. It then sends itself a PaletteChange event, and notifies all its descendants so they can resolve their palettes as well.
By default, this property contains the application's default palette.
Definition at line 73 of file qgraphicswidget.h.
Referenced by _q_paintItem().
|
private |
the preferred size of the widget
Definition at line 78 of file qgraphicswidget.h.
|
private |
the size of the widget
Calling resize() resizes the widget to a size bounded by minimumSize() and maximumSize(). This property only affects the widget's width and height (e.g., its right and bottom edges); the widget's position and top-left corner remains unaffected.
Resizing a widget triggers the widget to immediately receive a GraphicsSceneResize event with the widget's old and new size. If the widget has a layout assigned when this event arrives, the layout will be activated and it will automatically update any child widgets's geometry.
This property does not affect any layout of the parent widget. If the widget itself is managed by a parent layout; e.g., it has a parent widget with a layout assigned, that layout will not activate.
By default, this property contains a size with zero width and height.
Definition at line 76 of file qgraphicswidget.h.
Referenced by _q_boundGeometryToSizeConstraints(), QDeclarativeLoaderPrivate::_q_updateSize(), and closestAcceptableSize().
|
private |
the size policy for the widget
Definition at line 80 of file qgraphicswidget.h.
|
private |
the widget's window flags
Window flags are a combination of a window type (e.g., Qt::Dialog) and several flags giving hints on the behavior of the window. The behavior is platform-dependent.
By default, this property contains no window flags.
Windows are panels. If you set the Qt::Window flag, the ItemIsPanel flag will be set automatically. If you clear the Qt::Window flag, the ItemIsPanel flag is also cleared. Note that the ItemIsPanel flag can be set independently of Qt::Window.
Definition at line 82 of file qgraphicswidget.h.
Referenced by _q_paintItem(), and QGraphicsItem::mousePressEvent().
|
private |
This property holds the window title (caption).
This property is only used for windows.
By default, if no title has been set, this property contains an empty string.
Definition at line 83 of file qgraphicswidget.h.