 |
Qt 4.8
|
|
Qt 4.8
|
The QGraphicsView class provides a widget for displaying the contents of a QGraphicsScene. More...
#include <qgraphicsview.h>
Public Types | |
| enum | CacheModeFlag { CacheNone = 0x0, CacheBackground = 0x1 } |
| This enum describes the flags that you can set for a QGraphicsView's cache mode. More... | |
| enum | DragMode { NoDrag, ScrollHandDrag, RubberBandDrag } |
| This enum describes the default action for the view when pressing and dragging the mouse over the viewport. More... | |
| enum | OptimizationFlag { DontClipPainter = 0x1, DontSavePainterState = 0x2, DontAdjustForAntialiasing = 0x4, IndirectPainting = 0x8 } |
| This enum describes flags that you can enable to improve rendering performance in QGraphicsView. More... | |
| enum | ViewportAnchor { NoAnchor, AnchorViewCenter, AnchorUnderMouse } |
| This enums describe the possible anchors that QGraphicsView can use when the user resizes the view or when the view is transformed. More... | |
| enum | ViewportUpdateMode { FullViewportUpdate, MinimalViewportUpdate, SmartViewportUpdate, NoViewportUpdate, BoundingRectViewportUpdate } |
| This enum describes how QGraphicsView updates its viewport when the scene contents change or are exposed. More... | |
 Public Types inherited from QFrame | |
| enum | Shadow { Plain = 0x0010, Raised = 0x0020, Sunken = 0x0030 } |
| This enum type defines the types of shadow that are used to give a 3D effect to frames. More... | |
| enum | Shape { NoFrame = 0, Box = 0x0001, Panel = 0x0002, WinPanel = 0x0003, HLine = 0x0004, VLine = 0x0005, StyledPanel = 0x0006 } |
| This enum type defines the shapes of frame available. More... | |
| enum | StyleMask { Shadow_Mask = 0x00f0, Shape_Mask = 0x000f } |
| This enum defines two constants that can be used to extract the two components of frameStyle(): More... | |
| Public Types inherited from QWidget | |
| enum | RenderFlag { DrawWindowBackground = 0x1, DrawChildren = 0x2, IgnoreMask = 0x4 } |
| This enum describes how to render the widget when calling QWidget::render(). More... | |
| Public Types inherited from QPaintDevice | |
| enum | PaintDeviceMetric { PdmWidth = 1, PdmHeight, PdmWidthMM, PdmHeightMM, PdmNumColors, PdmDepth, PdmDpiX, PdmDpiY, PdmPhysicalDpiX, PdmPhysicalDpiY } |
Public Slots | |
| void | invalidateScene (const QRectF &rect=QRectF(), QGraphicsScene::SceneLayers layers=QGraphicsScene::AllLayers) |
| Invalidates and schedules a redraw of layers inside rect. More... | |
| void | updateScene (const QList< QRectF > &rects) |
| Schedules an update of the scene rectangles rects. More... | |
| void | updateSceneRect (const QRectF &rect) |
| Notifies QGraphicsView that the scene's scene rect has changed. More... | |
| Public Slots inherited from QWidget | |
| bool | close () |
| Closes this widget. More... | |
| void | hide () |
| Hides the widget. More... | |
| void | lower () |
| Lowers the widget to the bottom of the parent widget's stack. More... | |
| void | raise () |
| Raises this widget to the top of the parent widget's stack. More... | |
| void | repaint () |
| Repaints the widget directly by calling paintEvent() immediately, unless updates are disabled or the widget is hidden. More... | |
| void | setDisabled (bool) |
| Disables widget input events if disable is true; otherwise enables input events. More... | |
| void | setEnabled (bool) |
| void | setFocus () |
| Gives the keyboard input focus to this widget (or its focus proxy) if this widget or one of its parents is the active window. More... | |
| void | setHidden (bool hidden) |
| Convenience function, equivalent to setVisible(!hidden). More... | |
| QT_MOC_COMPAT void | setShown (bool shown) |
| Use setVisible(shown) instead. More... | |
| void | setStyleSheet (const QString &styleSheet) |
| virtual void | setVisible (bool visible) |
| void | setWindowModified (bool) |
| void | setWindowTitle (const QString &) |
| void | show () |
| Shows the widget and its child widgets. More... | |
| void | showFullScreen () |
| Shows the widget in full-screen mode. More... | |
| void | showMaximized () |
| Shows the widget maximized. More... | |
| void | showMinimized () |
| Shows the widget minimized, as an icon. More... | |
| void | showNormal () |
| Restores the widget after it has been maximized or minimized. More... | |
| void | update () |
| Updates the widget unless updates are disabled or the widget is hidden. More... | |
| Public Slots inherited from QObject | |
| void | deleteLater () |
| Schedules this object for deletion. More... | |
Public Functions | |
| Qt::Alignment | alignment () const |
| QBrush | backgroundBrush () const |
| CacheMode | cacheMode () const |
| void | centerOn (const QPointF &pos) |
| Scrolls the contents of the viewport to ensure that the scene coordinate pos, is centered in the view. More... | |
| void | centerOn (qreal x, qreal y) |
| This function is provided for convenience. More... | |
| void | centerOn (const QGraphicsItem *item) |
| Scrolls the contents of the viewport to ensure that item is centered in the view. More... | |
| DragMode | dragMode () const |
| void | ensureVisible (const QRectF &rect, int xmargin=50, int ymargin=50) |
| Scrolls the contents of the viewport so that the scene rectangle rect is visible, with margins specified in pixels by xmargin and ymargin. More... | |
| void | ensureVisible (qreal x, qreal y, qreal w, qreal h, int xmargin=50, int ymargin=50) |
| This function is provided for convenience. More... | |
| void | ensureVisible (const QGraphicsItem *item, int xmargin=50, int ymargin=50) |
| Scrolls the contents of the viewport so that the center of item item is visible, with margins specified in pixels by xmargin and ymargin. More... | |
| void | fitInView (const QRectF &rect, Qt::AspectRatioMode aspectRadioMode=Qt::IgnoreAspectRatio) |
| Scales the view matrix and scrolls the scroll bars to ensure that the scene rectangle rect fits inside the viewport. More... | |
| void | fitInView (qreal x, qreal y, qreal w, qreal h, Qt::AspectRatioMode aspectRadioMode=Qt::IgnoreAspectRatio) |
| void | fitInView (const QGraphicsItem *item, Qt::AspectRatioMode aspectRadioMode=Qt::IgnoreAspectRatio) |
| Ensures that item fits tightly inside the view, scaling the view according to aspectRatioMode. More... | |
| QBrush | foregroundBrush () const |
| QVariant | inputMethodQuery (Qt::InputMethodQuery query) const |
| Reimplemented Function More... | |
| bool | isInteractive () const |
| bool | isTransformed () const |
| Returns true if the view is transformed (i. More... | |
| QGraphicsItem * | itemAt (const QPoint &pos) const |
| Returns the item at position pos, which is in viewport coordinates. More... | |
| QGraphicsItem * | itemAt (int x, int 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 function is provided for convenience. More... | |
| QList< QGraphicsItem * > | items () const |
| Returns a list of all the items in the associated scene, in descending stacking order (i.e., the first item in the returned list is the uppermost item). More... | |
| QList< QGraphicsItem * > | items (const QPoint &pos) const |
| Returns a list of all the items at the position pos in the view. More... | |
| QList< QGraphicsItem * > | items (int x, int y) const |
| This function is provided for convenience. More... | |
| QList< QGraphicsItem * > | items (const QRect &rect, Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const |
| Returns a list of all the items that, depending on mode, are either contained by or intersect with rect. More... | |
| QList< QGraphicsItem * > | items (int x, int y, int w, int h, Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const |
| QList< QGraphicsItem * > | items (const QPolygon &polygon, Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const |
| Returns a list of all the items that, depending on mode, are either contained by or intersect with polygon. More... | |
| QList< QGraphicsItem * > | items (const QPainterPath &path, Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const |
| Returns a list of all the items that, depending on mode, are either contained by or intersect with path. More... | |
| QPoint | mapFromScene (const QPointF &point) const |
| Returns the scene coordinate point to viewport coordinates. More... | |
| QPolygon | mapFromScene (const QRectF &rect) const |
| Returns the scene rectangle rect to a viewport coordinate polygon. More... | |
| QPolygon | mapFromScene (const QPolygonF &polygon) const |
| Returns the scene coordinate polygon polygon to a viewport coordinate polygon. More... | |
| QPainterPath | mapFromScene (const QPainterPath &path) const |
| Returns the scene coordinate painter path path to a viewport coordinate painter path. More... | |
| QPoint | mapFromScene (qreal x, qreal y) const |
| This function is provided for convenience. More... | |
| QPolygon | mapFromScene (qreal x, qreal y, qreal w, qreal h) const |
| This function is provided for convenience. More... | |
| QPointF | mapToScene (const QPoint &point) const |
| Returns the viewport coordinate point mapped to scene coordinates. More... | |
| QPolygonF | mapToScene (const QRect &rect) const |
| Returns the viewport rectangle rect mapped to a scene coordinate polygon. More... | |
| QPolygonF | mapToScene (const QPolygon &polygon) const |
| Returns the viewport polygon polygon mapped to a scene coordinate polygon. More... | |
| QPainterPath | mapToScene (const QPainterPath &path) const |
| Returns the viewport painter path path mapped to a scene coordinate painter path. More... | |
| QPointF | mapToScene (int x, int y) const |
| This function is provided for convenience. More... | |
| QPolygonF | mapToScene (int x, int y, int w, int h) const |
| This function is provided for convenience. More... | |
| QMatrix | matrix () const |
| Returns the current transformation matrix for the view. More... | |
| OptimizationFlags | optimizationFlags () const |
| QGraphicsView (QWidget *parent=0) | |
| Constructs a QGraphicsView. More... | |
| QGraphicsView (QGraphicsScene *scene, QWidget *parent=0) | |
| Constructs a QGraphicsView and sets the visualized scene to scene. More... | |
| void | render (QPainter *painter, const QRectF &target=QRectF(), const QRect &source=QRect(), Qt::AspectRatioMode aspectRatioMode=Qt::KeepAspectRatio) |
| Renders the source rect, which is in view coordinates, from the scene into target, which is in paint device coordinates, using painter. More... | |
| QPainter::RenderHints | renderHints () const |
| void | resetCachedContent () |
| Resets any cached content. More... | |
| void | resetMatrix () |
| Resets the view transformation matrix to the identity matrix. More... | |
| void | resetTransform () |
| Resets the view transformation to the identity matrix. More... | |
| ViewportAnchor | resizeAnchor () const |
| void | rotate (qreal angle) |
| Rotates the current view transformation angle degrees clockwise. More... | |
| Qt::ItemSelectionMode | rubberBandSelectionMode () const |
| void | scale (qreal sx, qreal sy) |
| Scales the current view transformation by (sx, sy). More... | |
| QGraphicsScene * | scene () const |
| Returns a pointer to the scene that is currently visualized in the view. More... | |
| QRectF | sceneRect () const |
| void | setAlignment (Qt::Alignment alignment) |
| void | setBackgroundBrush (const QBrush &brush) |
| void | setCacheMode (CacheMode mode) |
| void | setDragMode (DragMode mode) |
| void | setForegroundBrush (const QBrush &brush) |
| void | setInteractive (bool allowed) |
| void | setMatrix (const QMatrix &matrix, bool combine=false) |
| Sets the view's current transformation matrix to matrix. More... | |
| void | setOptimizationFlag (OptimizationFlag flag, bool enabled=true) |
| Enables flag if enabled is true; otherwise disables flag. More... | |
| void | setOptimizationFlags (OptimizationFlags flags) |
| void | setRenderHint (QPainter::RenderHint hint, bool enabled=true) |
| If enabled is true, the render hint hint is enabled; otherwise it is disabled. More... | |
| void | setRenderHints (QPainter::RenderHints hints) |
| void | setResizeAnchor (ViewportAnchor anchor) |
| void | setRubberBandSelectionMode (Qt::ItemSelectionMode mode) |
| void | setScene (QGraphicsScene *scene) |
| Sets the current scene to scene. More... | |
| void | setSceneRect (const QRectF &rect) |
| void | setSceneRect (qreal x, qreal y, qreal w, qreal h) |
| void | setTransform (const QTransform &matrix, bool combine=false) |
| Sets the view's current transformation matrix to matrix. More... | |
| void | setTransformationAnchor (ViewportAnchor anchor) |
| void | setViewportUpdateMode (ViewportUpdateMode mode) |
| void | shear (qreal sh, qreal sv) |
| Shears the current view transformation by (sh, sv). More... | |
| QSize | sizeHint () const |
| Reimplemented Function More... | |
| QTransform | transform () const |
| Returns the current transformation matrix for the view. More... | |
| ViewportAnchor | transformationAnchor () const |
| void | translate (qreal dx, qreal dy) |
| Translates the current view transformation by (dx, dy). More... | |
| QTransform | viewportTransform () const |
| Returns a matrix that maps viewport coordinates to scene coordinates. More... | |
| ViewportUpdateMode | viewportUpdateMode () const |
| ~QGraphicsView () | |
| Destructs the QGraphicsView object. More... | |
| Public Functions inherited from QAbstractScrollArea | |
| void | addScrollBarWidget (QWidget *widget, Qt::Alignment alignment) |
| Adds widget as a scroll bar widget in the location specified by alignment. More... | |
| QWidget * | cornerWidget () const |
| Returns the widget in the corner between the two scroll bars. More... | |
| QScrollBar * | horizontalScrollBar () const |
| Returns the horizontal scroll bar. More... | |
| Qt::ScrollBarPolicy | horizontalScrollBarPolicy () const |
| QSize | maximumViewportSize () const |
| Returns the size of the viewport as if the scroll bars had no valid scrolling range. More... | |
| QSize | minimumSizeHint () const |
| Reimplemented Function More... | |
| QAbstractScrollArea (QWidget *parent=0) | |
| Constructs a viewport. More... | |
| QWidgetList | scrollBarWidgets (Qt::Alignment alignment) |
| Returns a list of the currently set scroll bar widgets. More... | |
| void | setCornerWidget (QWidget *widget) |
| Sets the widget in the corner between the two scroll bars to be widget. More... | |
| void | setHorizontalScrollBar (QScrollBar *scrollbar) |
| Replaces the existing horizontal scroll bar with scrollBar, and sets all the former scroll bar's slider properties on the new scroll bar. More... | |
| void | setHorizontalScrollBarPolicy (Qt::ScrollBarPolicy) |
| void | setVerticalScrollBar (QScrollBar *scrollbar) |
| Replaces the existing vertical scroll bar with scrollBar, and sets all the former scroll bar's slider properties on the new scroll bar. More... | |
| void | setVerticalScrollBarPolicy (Qt::ScrollBarPolicy) |
| void | setViewport (QWidget *widget) |
| Sets the viewport to be the given widget. More... | |
| QSize | sizeHint () const |
| Reimplemented Function More... | |
| QScrollBar * | verticalScrollBar () const |
| Returns the vertical scroll bar. More... | |
| Qt::ScrollBarPolicy | verticalScrollBarPolicy () const |
| QWidget * | viewport () const |
| Returns the viewport widget. More... | |
| ~QAbstractScrollArea () | |
| Destroys the viewport. More... | |
| Public Functions inherited from QFrame | |
| QRect | frameRect () const |
| Shadow | frameShadow () const |
| Shape | frameShape () const |
| int | frameStyle () const |
| Returns the frame style. More... | |
| int | frameWidth () const |
| int | lineWidth () const |
| int | midLineWidth () const |
| QFrame (QWidget *parent=0, Qt::WindowFlags f=0) | |
| Constructs a frame widget with frame style NoFrame and a 1-pixel frame width. More... | |
| void | setFrameRect (const QRect &) |
| em>Reimplemented Function More... | |
| void | setFrameShadow (Shadow) |
| void | setFrameShape (Shape) |
| void | setFrameStyle (int) |
| Sets the frame style to style. More... | |
| void | setLineWidth (int) |
| void | setMidLineWidth (int) |
| QSize | sizeHint () const |
| em>Reimplemented Function More... | |
| ~QFrame () | |
| Destroys the frame. More... | |
| Public Functions inherited from QWidget | |
| bool | acceptDrops () const |
| QString | accessibleDescription () const |
| QString | accessibleName () const |
| QList< QAction * > | actions () const |
| Returns the (possibly empty) list of this widget's actions. More... | |
| void | activateWindow () |
| Sets the top-level widget containing this widget to be the active window. 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 fit its contents. More... | |
| bool | autoFillBackground () const |
| QPalette::ColorRole | backgroundRole () const |
| Returns the background role of the widget. More... | |
| QSize | baseSize () const |
| QWidget * | childAt (int x, int y) const |
| Returns the visible child widget at the position ({x}, {y}) in the widget's coordinate system. More... | |
| QWidget * | childAt (const QPoint &p) const |
| Returns the visible child widget at point p in the widget's own coordinate system. More... | |
| QRect | childrenRect () const |
| QRegion | childrenRegion () const |
| void | clearFocus () |
| Takes keyboard input focus from the widget. More... | |
| void | clearMask () |
| Removes any mask set by setMask(). More... | |
| QMargins | contentsMargins () const |
| The contentsMargins function returns the widget's contents margins. More... | |
| QRect | contentsRect () const |
| Returns the area inside the widget's margins. More... | |
| Qt::ContextMenuPolicy | contextMenuPolicy () const |
| void | createWinId () |
| QCursor | cursor () const |
| int | devType () const |
| WId | effectiveWinId () const |
| Returns the effective window system identifier of the widget, i. More... | |
| void | ensurePolished () const |
| Ensures that the widget has been polished by QStyle (i.e., has a proper font and palette). More... | |
| Qt::FocusPolicy | focusPolicy () const |
| QWidget * | focusProxy () const |
| Returns the focus proxy, or 0 if there is no focus proxy. More... | |
| QWidget * | focusWidget () const |
| Returns the last child of this widget that setFocus had been called on. More... | |
| const QFont & | font () const |
| QFontInfo | fontInfo () const |
| Returns the font info for the widget's current font. More... | |
| QFontMetrics | fontMetrics () const |
| Returns the font metrics for the widget's current font. More... | |
| QPalette::ColorRole | foregroundRole () const |
| Returns the foreground role. More... | |
| QRect | frameGeometry () const |
| QSize | frameSize () const |
| const QRect & | geometry () const |
| void | getContentsMargins (int *left, int *top, int *right, int *bottom) const |
| Returns the widget's contents margins for left, top, right, and bottom. More... | |
| HDC | getDC () const |
| Returns the window system handle of the widget, for low-level access. More... | |
| void | grabGesture (Qt::GestureType type, Qt::GestureFlags flags=Qt::GestureFlags()) |
| Subscribes the widget to a given gesture with specific flags. More... | |
| void | grabKeyboard () |
| Grabs the keyboard input. More... | |
| void | grabMouse () |
| Grabs the mouse input. More... | |
| void | grabMouse (const QCursor &) |
| int | grabShortcut (const QKeySequence &key, 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... | |
| QGraphicsEffect * | graphicsEffect () const |
| The graphicsEffect function returns a pointer to the widget's graphics effect. More... | |
| QGraphicsProxyWidget * | graphicsProxyWidget () const |
| Returns the proxy widget for the corresponding embedded widget in a graphics view; otherwise returns 0. More... | |
| bool | hasFocus () const |
| bool | hasMouseTracking () const |
| int | height () const |
| virtual int | heightForWidth (int) const |
| Returns the preferred height for this widget, given the width w. More... | |
| QInputContext * | inputContext () |
| This function returns the QInputContext for this widget. More... | |
| Qt::InputMethodHints | inputMethodHints () const |
| 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... | |
| WId | internalWinId () const |
| Returns the window system identifier of the widget, or 0 if the widget is not created yet. More... | |
| bool | isActiveWindow () const |
| bool | isAncestorOf (const QWidget *child) const |
| Returns true if this widget is a parent, (or grandparent and so on to any level), of the given child, and both widgets are within the same window; otherwise returns false. More... | |
| bool | isEnabled () const |
| bool | isEnabledTo (QWidget *) const |
| Returns true if this widget would become enabled if ancestor is enabled; otherwise returns false. More... | |
| bool | isEnabledToTLW () const |
| This function is deprecated. More... | |
| bool | isFullScreen () const |
| bool | isHidden () const |
| Returns true if the widget is hidden, otherwise returns false. More... | |
| bool | isLeftToRight () const |
| bool | isMaximized () const |
| bool | isMinimized () const |
| bool | isModal () const |
| bool | isRightToLeft () const |
| bool | isTopLevel () const |
| Use isWindow() instead. More... | |
| bool | isVisible () const |
| bool | isVisibleTo (QWidget *) const |
| Returns true if this widget would become visible if ancestor is shown; otherwise returns false. More... | |
| bool | isWindow () const |
| Returns true if the widget is an independent window, otherwise returns false. More... | |
| bool | isWindowModified () const |
| QLayout * | layout () const |
| Returns the layout manager that is installed on this widget, or 0 if no layout manager is installed. More... | |
| Qt::LayoutDirection | layoutDirection () const |
| QLocale | locale () const |
| Qt::HANDLE | macCGHandle () const |
| Returns the CoreGraphics handle of the widget. More... | |
| Qt::HANDLE | macQDHandle () const |
| Returns the QuickDraw handle of the widget. More... | |
| QPoint | mapFrom (QWidget *, const QPoint &) const |
| Translates the widget coordinate pos from the coordinate system of parent to this widget's coordinate system. More... | |
| QPoint | mapFromGlobal (const QPoint &) const |
| Translates the global screen coordinate pos to widget coordinates. More... | |
| QPoint | mapFromParent (const QPoint &) const |
| Translates the parent widget coordinate pos to widget coordinates. More... | |
| QPoint | mapTo (QWidget *, const QPoint &) const |
| Translates the widget coordinate pos to the coordinate system of parent. More... | |
| QPoint | mapToGlobal (const QPoint &) const |
| Translates the widget coordinate pos to global screen coordinates. More... | |
| QPoint | mapToParent (const QPoint &) const |
| Translates the widget coordinate pos to a coordinate in the parent widget. More... | |
| QRegion | mask () const |
| Returns the mask currently set on a widget. More... | |
| int | maximumHeight () const |
| QSize | maximumSize () const |
| int | maximumWidth () const |
| int | minimumHeight () const |
| QSize | minimumSize () const |
| int | minimumWidth () const |
| void | move (int x, int y) |
| This corresponds to move(QPoint(x, y)). More... | |
| void | move (const QPoint &) |
| QWidget * | nativeParentWidget () const |
| Returns the native parent for this widget, i. More... | |
| QWidget * | nextInFocusChain () const |
| Returns the next widget in this widget's focus chain. More... | |
| QRect | normalGeometry () const |
| void | overrideWindowFlags (Qt::WindowFlags type) |
| Sets the window flags for the widget to flags, without telling the window system. More... | |
| void | overrideWindowState (Qt::WindowStates state) |
| QPaintEngine * | paintEngine () const |
| Returns the widget's paint engine. More... | |
| const QPalette & | palette () const |
| QWidget * | parentWidget () const |
| Returns the parent of this widget, or 0 if it does not have any parent widget. More... | |
| QPoint | pos () const |
| QWidget * | previousInFocusChain () const |
| The previousInFocusChain function returns the previous widget in this widget's focus chain. More... | |
| QWidget (QWidget *parent=0, Qt::WindowFlags f=0) | |
| Constructs a widget which is a child of parent, with widget flags set to f. More... | |
| QRect | rect () const |
| void | releaseDC (HDC) const |
| Releases the HDC hdc acquired by a previous call to getDC(). More... | |
| void | releaseKeyboard () |
| Releases the keyboard grab. More... | |
| void | releaseMouse () |
| Releases the mouse grab. 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 | render (QPaintDevice *target, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground|DrawChildren)) |
| Renders the sourceRegion of this widget into the target using renderFlags to determine how to render. More... | |
| void | render (QPainter *painter, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground|DrawChildren)) |
| Renders the widget into the painter's QPainter::device(). More... | |
| void | repaint (int x, int y, int w, int h) |
| This version repaints a rectangle (x, y, w, h) inside the widget. More... | |
| void | repaint (const QRect &) |
| This version repaints a rectangle rect inside the widget. More... | |
| void | repaint (const QRegion &) |
| This version repaints a region rgn inside the widget. More... | |
| void | resize (int w, int h) |
| This corresponds to resize(QSize(w, h)). More... | |
| void | resize (const QSize &) |
| bool | restoreGeometry (const QByteArray &geometry) |
| Restores the geometry and state top-level widgets stored in the byte array geometry. More... | |
| QByteArray | saveGeometry () const |
| Saves the current geometry and state for top-level widgets. More... | |
| void | scroll (int dx, int dy) |
| Scrolls the widget including its children dx pixels to the right and dy downward. More... | |
| void | scroll (int dx, int dy, const QRect &) |
| This version only scrolls r and does not move the children of the widget. More... | |
| void | setAcceptDrops (bool on) |
| void | setAccessibleDescription (const QString &description) |
| void | setAccessibleName (const QString &name) |
| void | setAttribute (Qt::WidgetAttribute, bool on=true) |
| Sets the attribute attribute on this widget if on is true; otherwise clears the attribute. More... | |
| void | setAutoFillBackground (bool enabled) |
| void | setBackgroundRole (QPalette::ColorRole) |
| Sets the background role of the widget to role. More... | |
| void | setBaseSize (const QSize &) |
| void | setBaseSize (int basew, int baseh) |
| This corresponds to setBaseSize(QSize(basew, baseh)). More... | |
| void | setContentsMargins (int left, int top, int right, int bottom) |
| Sets the margins around the contents of the widget to have the sizes left, top, right, and bottom. More... | |
| void | setContentsMargins (const QMargins &margins) |
| The setContentsMargins function sets the margins around the widget's contents. More... | |
| void | setContextMenuPolicy (Qt::ContextMenuPolicy policy) |
| void | setCursor (const QCursor &) |
| void | setFixedHeight (int h) |
| Sets both the minimum and maximum heights of the widget to h without changing the widths. More... | |
| void | setFixedSize (const QSize &) |
| Sets both the minimum and maximum sizes of the widget to s, thereby preventing it from ever growing or shrinking. More... | |
| void | setFixedSize (int w, int h) |
| Sets the width of the widget to w and the height to h. More... | |
| void | setFixedWidth (int w) |
| Sets both the minimum and maximum width of the widget to w without changing the heights. More... | |
| void | setFocus (Qt::FocusReason reason) |
| Gives the keyboard input focus to this widget (or its focus proxy) if this widget or one of its parents is the active window. More... | |
| void | setFocusPolicy (Qt::FocusPolicy policy) |
| void | setFocusProxy (QWidget *) |
| Sets the widget's focus proxy to widget w. More... | |
| void | setFont (const QFont &) |
| Use the single-argument overload instead. More... | |
| void | setForegroundRole (QPalette::ColorRole) |
| Sets the foreground role of the widget to role. More... | |
| void | setGeometry (int x, int y, int w, int h) |
| This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.This corresponds to setGeometry(QRect(x, y, w, h)). More... | |
| void | setGeometry (const QRect &) |
| void | setGraphicsEffect (QGraphicsEffect *effect) |
| The setGraphicsEffect function is for setting the widget's graphics effect. More... | |
| void | setInputContext (QInputContext *) |
| This function sets the input context context on this widget. More... | |
| void | setInputMethodHints (Qt::InputMethodHints hints) |
| void | setLayout (QLayout *) |
| Sets the layout manager for this widget to layout. More... | |
| void | setLayoutDirection (Qt::LayoutDirection direction) |
| void | setLocale (const QLocale &locale) |
| void | setMask (const QBitmap &) |
| Causes only the pixels of the widget for which bitmap has a corresponding 1 bit to be visible. More... | |
| void | setMask (const QRegion &) |
| Causes only the parts of the widget which overlap region to be visible. More... | |
| void | setMaximumHeight (int maxh) |
| void | setMaximumSize (const QSize &) |
| void | setMaximumSize (int maxw, int maxh) |
| This function corresponds to setMaximumSize(QSize(maxw, maxh)). More... | |
| void | setMaximumWidth (int maxw) |
| void | setMinimumHeight (int minh) |
| void | setMinimumSize (const QSize &) |
| void | setMinimumSize (int minw, int minh) |
| This function corresponds to setMinimumSize(QSize(minw, minh)). More... | |
| void | setMinimumWidth (int minw) |
| void | setMouseTracking (bool enable) |
| void | setPalette (const QPalette &) |
| Use the single-argument overload instead. More... | |
| void | setParent (QWidget *parent) |
| Sets the parent of the widget to parent, and resets the window flags. More... | |
| void | setParent (QWidget *parent, Qt::WindowFlags f) |
| This function also takes widget flags, f as an argument. More... | |
| void | setShortcutAutoRepeat (int id, bool enable=true) |
| If enable is true, auto repeat of the shortcut with the given id is enabled; otherwise it is disabled. More... | |
| void | setShortcutEnabled (int id, bool enable=true) |
| If enable is true, the shortcut with the given id is enabled; otherwise the shortcut is disabled. More... | |
| void | setSizeIncrement (const QSize &) |
| void | setSizeIncrement (int w, int h) |
| Sets the x (width) size increment to w and the y (height) size increment to h. More... | |
| void | setSizePolicy (QSizePolicy) |
| void | setSizePolicy (QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical) |
| Sets the size policy of the widget to horizontal and vertical, with standard stretch and no height-for-width. More... | |
| void | setStatusTip (const QString &) |
| void | setStyle (QStyle *) |
| Sets the widget's GUI style to style. More... | |
| void | setToolTip (const QString &) |
| void | setUpdatesEnabled (bool enable) |
| void | setupUi (QWidget *widget) |
| Sets up the user interface for the specified widget. More... | |
| void | setWhatsThis (const QString &) |
| void | setWindowFilePath (const QString &filePath) |
| void | setWindowFlags (Qt::WindowFlags type) |
| void | setWindowIcon (const QIcon &icon) |
| void | setWindowIconText (const QString &) |
| void | setWindowModality (Qt::WindowModality windowModality) |
| void | setWindowOpacity (qreal level) |
| void | setWindowRole (const QString &) |
| Sets the window's role to role. More... | |
| void | setWindowState (Qt::WindowStates state) |
| Sets the window state to windowState. More... | |
| void | setWindowSurface (QWindowSurface *surface) |
| Sets the window surface to be the surface specified. More... | |
| QSize | size () const |
| QSize | sizeIncrement () const |
| QSizePolicy | sizePolicy () const |
| void | stackUnder (QWidget *) |
| Places the widget under w in the parent widget's stack. More... | |
| QString | statusTip () const |
| QStyle * | style () const |
| QString | styleSheet () const |
| bool | testAttribute (Qt::WidgetAttribute) const |
| Returns true if attribute attribute is set on this widget; otherwise returns false. More... | |
| QString | toolTip () const |
| QWidget * | topLevelWidget () const |
| bool | underMouse () const |
| Returns true if the widget is under the mouse cursor; otherwise returns false. More... | |
| void | ungrabGesture (Qt::GestureType type) |
| Unsubscribes the widget from a given gesture type. More... | |
| void | unsetCursor () |
| void | unsetLayoutDirection () |
| void | unsetLocale () |
| void | update (int x, int y, int w, int h) |
| This version updates a rectangle (x, y, w, h) inside the widget. More... | |
| void | update (const QRect &) |
| This version updates a rectangle rect inside the widget. More... | |
| void | update (const QRegion &) |
| This version repaints a region rgn inside the widget. More... | |
| void | updateGeometry () |
| Notifies the layout system that this widget has changed and may need to change geometry. More... | |
| bool | updatesEnabled () const |
| QRegion | visibleRegion () const |
| Returns the unobscured region where paint events can occur. More... | |
| QString | whatsThis () const |
| int | width () const |
| QWidget * | window () const |
| Returns the window for this widget, i.e. More... | |
| QString | windowFilePath () const |
| Qt::WindowFlags | windowFlags () const |
| Window flags are a combination of a type (e. More... | |
| QIcon | windowIcon () const |
| QString | windowIconText () const |
| Qt::WindowModality | windowModality () const |
| qreal | windowOpacity () const |
| QString | windowRole () const |
| Returns the window's role, or an empty string. More... | |
| Qt::WindowStates | windowState () const |
| Returns the current window state. More... | |
| QWindowSurface * | windowSurface () const |
| Returns the QWindowSurface this widget will be drawn into. More... | |
| QString | windowTitle () const |
| Qt::WindowType | windowType () const |
| Returns the window type of this widget. More... | |
| WId | winId () const |
| Returns the window system identifier of the widget. More... | |
| int | x () const |
| const QX11Info & | x11Info () const |
| Returns information about the configuration of the X display used to display the widget. More... | |
| Qt::HANDLE | x11PictureHandle () const |
| Returns the X11 Picture handle of the widget for XRender support. More... | |
| int | y () const |
| ~QWidget () | |
| Destroys the widget. 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 QPaintDevice | |
| int | colorCount () const |
| int | depth () const |
| int | height () const |
| int | heightMM () const |
| int | logicalDpiX () const |
| int | logicalDpiY () const |
| QT_DEPRECATED int | numColors () const |
| bool | paintingActive () const |
| int | physicalDpiX () const |
| int | physicalDpiY () const |
| int | width () const |
| int | widthMM () const |
| virtual | ~QPaintDevice () |
Protected Slots | |
| void | setupViewport (QWidget *widget) |
| This slot is called by QAbstractScrollArea after setViewport() has been called. More... | |
| Protected Slots inherited from QAbstractScrollArea | |
| void | setupViewport (QWidget *viewport) |
| This slot is called by QAbstractScrollArea after setViewport(viewport) has been called. More... | |
| Protected Slots inherited from QWidget | |
| void | updateMicroFocus () |
| Updates the widget's micro focus. More... | |
Protected Functions | |
| void | contextMenuEvent (QContextMenuEvent *event) |
| Reimplemented Function More... | |
| void | dragEnterEvent (QDragEnterEvent *event) |
| Reimplemented Function More... | |
| void | dragLeaveEvent (QDragLeaveEvent *event) |
| Reimplemented Function More... | |
| void | dragMoveEvent (QDragMoveEvent *event) |
| Reimplemented Function More... | |
| virtual void | drawBackground (QPainter *painter, const QRectF &rect) |
| Draws the background of the scene using painter, before any items and the foreground are drawn. More... | |
| virtual void | drawForeground (QPainter *painter, const QRectF &rect) |
| Draws the foreground of the scene using painter, after the background and all items are drawn. More... | |
| virtual void | drawItems (QPainter *painter, int numItems, QGraphicsItem *items[], const QStyleOptionGraphicsItem options[]) |
| Draws the items items in the scene using painter, after the background and before the foreground are drawn. More... | |
| void | dropEvent (QDropEvent *event) |
| Reimplemented Function More... | |
| bool | event (QEvent *event) |
| Reimplemented Function More... | |
| void | focusInEvent (QFocusEvent *event) |
| Reimplemented Function More... | |
| bool | focusNextPrevChild (bool next) |
| Reimplemented Function More... | |
| void | focusOutEvent (QFocusEvent *event) |
| Reimplemented Function More... | |
| void | inputMethodEvent (QInputMethodEvent *event) |
| Reimplemented Function More... | |
| void | keyPressEvent (QKeyEvent *event) |
| Reimplemented Function More... | |
| void | keyReleaseEvent (QKeyEvent *event) |
| Reimplemented Function More... | |
| void | mouseDoubleClickEvent (QMouseEvent *event) |
| Reimplemented Function More... | |
| void | mouseMoveEvent (QMouseEvent *event) |
| Reimplemented Function More... | |
| void | mousePressEvent (QMouseEvent *event) |
| Reimplemented Function More... | |
| void | mouseReleaseEvent (QMouseEvent *event) |
| Reimplemented Function More... | |
| void | paintEvent (QPaintEvent *event) |
| Reimplemented Function More... | |
| QGraphicsView (QGraphicsViewPrivate &, QWidget *parent=0) | |
| void | resizeEvent (QResizeEvent *event) |
| Reimplemented Function More... | |
| void | scrollContentsBy (int dx, int dy) |
| Reimplemented Function More... | |
| void | showEvent (QShowEvent *event) |
| Reimplemented Function More... | |
| bool | viewportEvent (QEvent *event) |
| Reimplemented Function More... | |
| void | wheelEvent (QWheelEvent *event) |
| Reimplemented Function More... | |
| Protected Functions inherited from QAbstractScrollArea | |
| void | contextMenuEvent (QContextMenuEvent *) |
| This event handler can be reimplemented in a subclass to receive context menu events for the viewport() widget. More... | |
| void | dragEnterEvent (QDragEnterEvent *) |
| This event handler can be reimplemented in a subclass to receive drag enter events (passed in event), for the viewport() widget. More... | |
| void | dragLeaveEvent (QDragLeaveEvent *) |
| This event handler can be reimplemented in a subclass to receive drag leave events (passed in event), for the viewport() widget. More... | |
| void | dragMoveEvent (QDragMoveEvent *) |
| This event handler can be reimplemented in a subclass to receive drag move events (passed in event), for the viewport() widget. More... | |
| void | dropEvent (QDropEvent *) |
| This event handler can be reimplemented in a subclass to receive drop events (passed in event), for the viewport() widget. More... | |
| bool | event (QEvent *) |
| Reimplemented Function More... | |
| void | keyPressEvent (QKeyEvent *) |
| This function is called with key event e when key presses occur. More... | |
| void | mouseDoubleClickEvent (QMouseEvent *) |
| This event handler can be reimplemented in a subclass to receive mouse double click events for the viewport() widget. More... | |
| void | mouseMoveEvent (QMouseEvent *) |
| This event handler can be reimplemented in a subclass to receive mouse move events for the viewport() widget. More... | |
| void | mousePressEvent (QMouseEvent *) |
| This event handler can be reimplemented in a subclass to receive mouse press events for the viewport() widget. More... | |
| void | mouseReleaseEvent (QMouseEvent *) |
| This event handler can be reimplemented in a subclass to receive mouse release events for the viewport() widget. More... | |
| void | paintEvent (QPaintEvent *) |
| This event handler can be reimplemented in a subclass to receive paint events (passed in event), for the viewport() widget. More... | |
| QAbstractScrollArea (QAbstractScrollAreaPrivate &dd, QWidget *parent=0) | |
| Creates a new QAbstractScrollAreaPrivate, dd with the given parent. More... | |
| void | resizeEvent (QResizeEvent *) |
| This event handler can be reimplemented in a subclass to receive resize events (passed in event), for the viewport() widget. More... | |
| void | setViewportMargins (int left, int top, int right, int bottom) |
| Sets the margins around the scrolling area to left, top, right and bottom. More... | |
| void | setViewportMargins (const QMargins &margins) |
| Sets margins around the scrolling area. More... | |
| void | wheelEvent (QWheelEvent *) |
| This event handler can be reimplemented in a subclass to receive wheel events for the viewport() widget. More... | |
| Protected Functions inherited from QFrame | |
| void | changeEvent (QEvent *) |
| This event handler can be reimplemented to handle state changes. More... | |
| void | drawFrame (QPainter *) |
| em>Reimplemented Function More... | |
| bool | event (QEvent *e) |
| Reimplemented Function More... | |
| void | paintEvent (QPaintEvent *) |
| This event handler can be reimplemented in a subclass to receive paint events passed in event. More... | |
| QFrame (QFramePrivate &dd, QWidget *parent=0, Qt::WindowFlags f=0) | |
| Protected Functions inherited from QWidget | |
| virtual void | actionEvent (QActionEvent *) |
| This event handler is called with the given event whenever the widget's actions are changed. More... | |
| virtual void | closeEvent (QCloseEvent *) |
| This event handler is called with the given event when Qt receives a window close request for a top-level widget from the window system. More... | |
| void | create (WId=0, bool initializeWindow=true, bool destroyOldWindow=true) |
| Creates a new widget window if window is 0, otherwise sets the widget's window to window. More... | |
| void | destroy (bool destroyWindow=true, bool destroySubWindows=true) |
| Frees up window system resources. More... | |
| virtual void | enabledChange (bool) |
| virtual void | enterEvent (QEvent *) |
| This event handler can be reimplemented in a subclass to receive widget enter events which are passed in the event parameter. More... | |
| bool | focusNextChild () |
| Finds a new widget to give the keyboard focus to, as appropriate for Tab, and returns true if it can find a new widget, or false if it can't. More... | |
| bool | focusPreviousChild () |
| Finds a new widget to give the keyboard focus to, as appropriate for Shift+Tab, and returns true if it can find a new widget, or false if it can't. More... | |
| virtual void | fontChange (const QFont &) |
| virtual void | hideEvent (QHideEvent *) |
| This event handler can be reimplemented in a subclass to receive widget hide events. More... | |
| virtual void | languageChange () |
| virtual void | leaveEvent (QEvent *) |
| This event handler can be reimplemented in a subclass to receive widget leave events which are passed in the event parameter. More... | |
| virtual bool | macEvent (EventHandlerCallRef, EventRef) |
| This special event handler can be reimplemented in a subclass to receive native Macintosh events. More... | |
| int | metric (PaintDeviceMetric) const |
| Internal implementation of the virtual QPaintDevice::metric() function. More... | |
| virtual void | moveEvent (QMoveEvent *) |
| This event handler can be reimplemented in a subclass to receive widget move events which are passed in the event parameter. More... | |
| virtual void | paletteChange (const QPalette &) |
| QWidget (QWidgetPrivate &d, QWidget *parent, Qt::WindowFlags f) | |
| virtual bool | qwsEvent (QWSEvent *) |
| This special event handler can be reimplemented in a subclass to receive native Qt for Embedded Linux events which are passed in the event parameter. More... | |
| void | resetInputContext () |
| This function can be called on the widget that currently has focus to reset the input method operating on it. More... | |
| virtual void | styleChange (QStyle &) |
| virtual void | tabletEvent (QTabletEvent *) |
| This event handler, for event event, can be reimplemented in a subclass to receive tablet events for the widget. More... | |
| virtual void | windowActivationChange (bool) |
| virtual bool | winEvent (MSG *message, long *result) |
| This special event handler can be reimplemented in a subclass to receive native Windows events which are passed in the message parameter. More... | |
| virtual bool | x11Event (XEvent *) |
| This special event handler can be reimplemented in a subclass to receive native X11 events passed in the event parameter. More... | |
| 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 QPaintDevice | |
| QPaintDevice () | |
Properties | |
| Qt::Alignment | alignment |
| the alignment of the scene in the view when the whole scene is visible. More... | |
| QBrush | backgroundBrush |
| the background brush of the scene. More... | |
| CacheMode | cacheMode |
| which parts of the view are cached More... | |
| DragMode | dragMode |
| the behavior for dragging the mouse over the scene while the left mouse button is pressed. More... | |
| QBrush | foregroundBrush |
| the foreground brush of the scene. More... | |
| bool | interactive |
| whether the view allowed scene interaction. More... | |
| OptimizationFlags | optimizationFlags |
| flags that can be used to tune QGraphicsView's performance. More... | |
| QPainter::RenderHints | renderHints |
| the default render hints for the view More... | |
| ViewportAnchor | resizeAnchor |
| how the view should position the scene when the view is resized. More... | |
| Qt::ItemSelectionMode | rubberBandSelectionMode |
| the behavior for selecting items with a rubber band selection rectangle. More... | |
| QRectF | sceneRect |
| the area of the scene visualized by this view. More... | |
| ViewportAnchor | transformationAnchor |
| how the view should position the scene during transformations. More... | |
| ViewportUpdateMode | viewportUpdateMode |
| how the viewport should update its contents. More... | |
Friends | |
| class | QGraphicsItemPrivate |
| class | QGraphicsScene |
| class | QGraphicsScenePrivate |
| class | QGraphicsSceneWidget |
Additional Inherited Members | |
| Signals inherited from QWidget | |
| void | customContextMenuRequested (const QPoint &pos) |
| This signal is emitted when the widget's contextMenuPolicy is Qt::CustomContextMenu, and the user has requested a context menu on the widget. 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... | |
| Static Public Functions inherited from QWidget | |
| static QWidget * | find (WId) |
| Returns a pointer to the widget with window identifer/handle id. More... | |
| static QWidget * | keyboardGrabber () |
| Returns the widget that is currently grabbing the keyboard input. More... | |
| static QWidget * | mouseGrabber () |
| Returns the widget that is currently grabbing the mouse input. More... | |
| static void | setTabOrder (QWidget *, QWidget *) |
| Puts the second widget after the first widget in the focus order. 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) |
| Static Public Functions inherited from QPaintDevice | |
| static QWSDisplay * | qwsDisplay () |
| Static Public Variables inherited from QObject | |
| static const QMetaObject | staticMetaObject |
| This variable stores the meta-object for the class. More... | |
| Protected Variables inherited from QObject | |
| QScopedPointer< QObjectData > | d_ptr |
| Protected Variables inherited from QPaintDevice | |
| ushort | painters |
| Static Protected Variables inherited from QObject | |
| static const QMetaObject | staticQtMetaObject |
| Related Functions inherited from QWidget | |
| QWidgetList | |
| WId | |
| Platform dependent window identifier. More... | |
| 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 QPaintDevice | |
| const Q_GUI_EXPORT QX11Info * | qt_x11Info (const QPaintDevice *pd) |
| Returns the QX11Info structure for the pd paint device. More... | |
The QGraphicsView class provides a widget for displaying the contents of a QGraphicsScene.
QGraphicsView visualizes the contents of a QGraphicsScene in a scrollable viewport. To create a scene with geometrical items, see QGraphicsScene's documentation. QGraphicsView is part of the Graphics View Framework.
To visualize a scene, you start by constructing a QGraphicsView object, passing the address of the scene you want to visualize to QGraphicsView's constructor. Alternatively, you can call setScene() to set the scene at a later point. After you call show(), the view will by default scroll to the center of the scene and display any items that are visible at this point. For example:
You can explicitly scroll to any position on the scene by using the scroll bars, or by calling centerOn(). By passing a point to centerOn(), QGraphicsView will scroll its viewport to ensure that the point is centered in the view. An overload is provided for scrolling to a QGraphicsItem, in which case QGraphicsView will see to that the center of the item is centered in the view. If all you want is to ensure that a certain area is visible, (but not necessarily centered,) you can call ensureVisible() instead.
QGraphicsView can be used to visualize a whole scene, or only parts of it. The visualized area is by default detected automatically when the view is displayed for the first time (by calling QGraphicsScene::itemsBoundingRect()). To set the visualized area rectangle yourself, you can call setSceneRect(). This will adjust the scroll bars' ranges appropriately. Note that although the scene supports a virtually unlimited size, the range of the scroll bars will never exceed the range of an integer (INT_MIN, INT_MAX).
QGraphicsView visualizes the scene by calling render(). By default, the items are drawn onto the viewport by using a regular QPainter, and using default render hints. To change the default render hints that QGraphicsView passes to QPainter when painting items, you can call setRenderHints().
By default, QGraphicsView provides a regular QWidget for the viewport widget. You can access this widget by calling viewport(), or you can replace it by calling setViewport(). To render using OpenGL, simply call setViewport(new QGLWidget). QGraphicsView takes ownership of the viewport widget.
QGraphicsView supports affine transformations, using QTransform. You can either pass a matrix to setTransform(), or you can call one of the convenience functions rotate(), scale(), translate() or shear(). The most two common transformations are scaling, which is used to implement zooming, and rotation. QGraphicsView keeps the center of the view fixed during a transformation. Because of the scene alignment (setAligment()), translating the view will have no visual impact.
You can interact with the items on the scene by using the mouse and keyboard. QGraphicsView translates the mouse and key events into scene events, (events that inherit QGraphicsSceneEvent,), and forward them to the visualized scene. In the end, it's the individual item that handles the events and reacts to them. For example, if you click on a selectable item, the item will typically let the scene know that it has been selected, and it will also redraw itself to display a selection rectangle. Similiary, if you click and drag the mouse to move a movable item, it's the item that handles the mouse moves and moves itself. Item interaction is enabled by default, and you can toggle it by calling setInteractive().
You can also provide your own custom scene interaction, by creating a subclass of QGraphicsView, and reimplementing the mouse and key event handlers. To simplify how you programmatically interact with items in the view, QGraphicsView provides the mapping functions mapToScene() and mapFromScene(), and the item accessors items() and itemAt(). These functions allow you to map points, rectangles, polygons and paths between view coordinates and scene coordinates, and to find items on the scene using view coordinates.
Definition at line 64 of file qgraphicsview.h.
This enum describes the flags that you can set for a QGraphicsView's cache mode.
| Enumerator | |
|---|---|
| CacheNone | |
| CacheBackground | |
Definition at line 92 of file qgraphicsview.h.
This enum describes the default action for the view when pressing and dragging the mouse over the viewport.
| Enumerator | |
|---|---|
| NoDrag | |
| ScrollHandDrag | |
| RubberBandDrag | |
Definition at line 98 of file qgraphicsview.h.
This enum describes flags that you can enable to improve rendering performance in QGraphicsView.
By default, none of these flags are set. Note that setting a flag usually imposes a side effect, and this effect can vary between paint devices and platforms.
| Enumerator | |
|---|---|
| DontClipPainter | |
| DontSavePainterState | |
| DontAdjustForAntialiasing | |
| IndirectPainting | |
Definition at line 112 of file qgraphicsview.h.
This enums describe the possible anchors that QGraphicsView can use when the user resizes the view or when the view is transformed.
| Enumerator | |
|---|---|
| NoAnchor | |
| AnchorViewCenter | |
| AnchorUnderMouse | |
Definition at line 86 of file qgraphicsview.h.
This enum describes how QGraphicsView updates its viewport when the scene contents change or are exposed.
| Enumerator | |
|---|---|
| FullViewportUpdate | |
| MinimalViewportUpdate | |
| SmartViewportUpdate | |
| NoViewportUpdate | |
| BoundingRectViewportUpdate | |
Definition at line 104 of file qgraphicsview.h.
| QGraphicsView::QGraphicsView | ( | QWidget * | parent = 0 | ) |
Constructs a QGraphicsView.
parent is passed to QWidget's constructor.
Definition at line 1141 of file qgraphicsview.cpp.
| QGraphicsView::QGraphicsView | ( | QGraphicsScene * | scene, |
| QWidget * | parent = 0 |
||
| ) |
Constructs a QGraphicsView and sets the visualized scene to scene.
parent is passed to QWidget's constructor.
Definition at line 1156 of file qgraphicsview.cpp.
| QGraphicsView::~QGraphicsView | ( | ) |
Destructs the QGraphicsView object.
Definition at line 1185 of file qgraphicsview.cpp.
|
protected |
Definition at line 1171 of file qgraphicsview.cpp.
| Qt::Alignment QGraphicsView::alignment | ( | ) | const |
Referenced by setAlignment(), and setRenderHint().
| QBrush QGraphicsView::backgroundBrush | ( | ) | const |
Referenced by inputMethodQuery(), and QmlJSDebugger::ColorPickerTool::pickColor().
| CacheMode QGraphicsView::cacheMode | ( | ) | const |
Referenced by setRubberBandSelectionMode().
| void QGraphicsView::centerOn | ( | const QPointF & | pos | ) |
Scrolls the contents of the viewport to ensure that the scene coordinate pos, is centered in the view.
Because pos is a floating point coordinate, and the scroll bars operate on integer coordinates, the centering is only an approximation.
Definition at line 1880 of file qgraphicsview.cpp.
Referenced by centerOn(), and fitInView().
This function is provided for convenience.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
It's equivalent to calling centerOn(QPointF(x, y)).
Definition at line 289 of file qgraphicsview.h.
| void QGraphicsView::centerOn | ( | const QGraphicsItem * | item | ) |
Scrolls the contents of the viewport to ensure that item is centered in the view.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 1926 of file qgraphicsview.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 2981 of file qgraphicsview.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3038 of file qgraphicsview.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3071 of file qgraphicsview.cpp.
| DragMode QGraphicsView::dragMode | ( | ) | const |
Referenced by setOptimizationFlag().
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3111 of file qgraphicsview.cpp.
Draws the background of the scene using painter, before any items and the foreground are drawn.
Reimplement this function to provide a custom background for this view.
If all you want is to define a color, texture or gradient for the background, you can call setBackgroundBrush() instead.
All painting is done in scene coordinates. rect is the exposed rectangle.
The default implementation fills rect using the view's backgroundBrush. If no such brush is defined (the default), the scene's drawBackground() function is called instead.
Definition at line 3783 of file qgraphicsview.cpp.
Referenced by paintEvent(), and render().
Draws the foreground of the scene using painter, after the background and all items are drawn.
Reimplement this function to provide a custom foreground for this view.
If all you want is to define a color, texture or gradient for the foreground, you can call setForegroundBrush() instead.
All painting is done in scene coordinates. rect is the exposed rectangle.
The default implementation fills rect using the view's foregroundBrush. If no such brush is defined (the default), the scene's drawForeground() function is called instead.
Definition at line 3811 of file qgraphicsview.cpp.
Referenced by paintEvent(), and render().
|
protectedvirtual |
Draws the items items in the scene using painter, after the background and before the foreground are drawn.
numItems is the number of items in items and options in options. options is a list of styleoptions; one for each item. Reimplement this function to provide custom item drawing for this view.
The default implementation calls the scene's drawItems() function.
Since Qt 4.6, this function is not called anymore unless the QGraphicsView::IndirectPainting flag is given as an Optimization flag.
Definition at line 3842 of file qgraphicsview.cpp.
Referenced by paintEvent(), and render().
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3008 of file qgraphicsview.cpp.
| void QGraphicsView::ensureVisible | ( | const QRectF & | rect, |
| int | xmargin = 50, |
||
| int | ymargin = 50 |
||
| ) |
Scrolls the contents of the viewport so that the scene rectangle rect is visible, with margins specified in pixels by xmargin and ymargin.
If the specified rect cannot be reached, the contents are scrolled to the nearest valid position. The default value for both margins is 50 pixels.
Definition at line 1940 of file qgraphicsview.cpp.
Referenced by ensureVisible(), and QGraphicsItem::ensureVisible().
|
inline |
This function is provided for convenience.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
It's equivalent to calling ensureVisible(QRectF(x, y, w, h), xmargin, ymargin).
Definition at line 291 of file qgraphicsview.h.
| void QGraphicsView::ensureVisible | ( | const QGraphicsItem * | item, |
| int | xmargin = 50, |
||
| int | ymargin = 50 |
||
| ) |
Scrolls the contents of the viewport so that the center of item item is visible, with margins specified in pixels by xmargin and ymargin.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
If the specified point cannot be reached, the contents are scrolled to the nearest valid position. The default value for both margins is 50 pixels.
Definition at line 1999 of file qgraphicsview.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QObject.
Definition at line 2813 of file qgraphicsview.cpp.
Referenced by viewportEvent().
| void QGraphicsView::fitInView | ( | const QRectF & | rect, |
| Qt::AspectRatioMode | aspectRatioMode = Qt::IgnoreAspectRatio |
||
| ) |
Scales the view matrix and scrolls the scroll bars to ensure that the scene rectangle rect fits inside the viewport.
rect must be inside the scene rect; otherwise, fitInView() cannot guarantee that the whole rect is visible.
This function keeps the view's rotation, translation, or shear. The view is scaled according to aspectRatioMode. rect will be centered in the view if it does not fit tightly.
It's common to call fitInView() from inside a reimplementation of resizeEvent(), to ensure that the whole scene, or parts of the scene, scales automatically to fit the new size of the viewport as the view is resized. Note though, that calling fitInView() from inside resizeEvent() can lead to unwanted resize recursion, if the new transformation toggles the automatic state of the scrollbars. You can toggle the scrollbar policies to always on or always off to prevent this (see horizontalScrollBarPolicy() and verticalScrollBarPolicy()).
If rect is empty, or if the viewport is too small, this function will do nothing.
Definition at line 2028 of file qgraphicsview.cpp.
Referenced by fitInView().
|
inline |
Definition at line 293 of file qgraphicsview.h.
| void QGraphicsView::fitInView | ( | const QGraphicsItem * | item, |
| Qt::AspectRatioMode | aspectRatioMode = Qt::IgnoreAspectRatio |
||
| ) |
Ensures that item fits tightly inside the view, scaling the view according to aspectRatioMode.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Definition at line 2094 of file qgraphicsview.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3140 of file qgraphicsview.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3155 of file qgraphicsview.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3163 of file qgraphicsview.cpp.
| QBrush QGraphicsView::foregroundBrush | ( | ) | const |
Referenced by setBackgroundBrush().
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3759 of file qgraphicsview.cpp.
|
virtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 2590 of file qgraphicsview.cpp.
|
slot |
Invalidates and schedules a redraw of layers inside rect.
rect is in scene coordinates. Any cached content for layers inside rect is unconditionally invalidated and redrawn.
You can call this function to notify QGraphicsView of changes to the background or the foreground of the scene. It is commonly used for scenes with tile-based backgrounds to notify changes when QGraphicsView has enabled background caching.
Note that QGraphicsView currently supports background caching only (see QGraphicsView::CacheBackground). This function is equivalent to calling update() if any layer but QGraphicsScene::BackgroundLayer is passed.
Definition at line 1601 of file qgraphicsview.cpp.
Referenced by QGraphicsScene::invalidate().
| bool QGraphicsView::isInteractive | ( | ) | const |
Definition at line 1629 of file qgraphicsview.cpp.
| bool QGraphicsView::isTransformed | ( | ) | const |
Returns true if the view is transformed (i.
e., a non-identity transform has been assigned, or the scrollbars are adjusted).
Definition at line 3888 of file qgraphicsview.cpp.
Referenced by QGraphicsScenePrivate::itemsAtPosition(), paintEvent(), QGraphicsScene::update(), and updateHelper().
| QGraphicsItem * QGraphicsView::itemAt | ( | const QPoint & | pos | ) | const |
Returns the item at position pos, which is in viewport coordinates.
If there are several items at this position, this function returns the topmost item.
Example:
Definition at line 2368 of file qgraphicsview.cpp.
Referenced by QGraphicsItem::unsetCursor().
|
inline |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.This function is provided for convenience.
It's equivalent to calling itemAt(QPoint(x, y)).
Definition at line 299 of file qgraphicsview.h.
| QList< QGraphicsItem * > QGraphicsView::items | ( | ) | const |
Returns a list of all the items in the associated scene, in descending stacking order (i.e., the first item in the returned list is the uppermost item).
Definition at line 2219 of file qgraphicsview.cpp.
Referenced by itemAt(), QGraphicsScenePrivate::itemsAtPosition(), and QGraphicsItem::setCursor().
| QList< QGraphicsItem * > QGraphicsView::items | ( | const QPoint & | pos | ) | const |
Returns a list of all the items at the position pos in the view.
The items are listed in descending stacking order (i.e., the first item in the list is the uppermost item, and the last item is the lowermost item). pos is in viewport coordinates.
This function is most commonly called from within mouse event handlers in a subclass in QGraphicsView. pos is in untransformed viewport coordinates, just like QMouseEvent::pos().
Definition at line 2241 of file qgraphicsview.cpp.
|
inline |
This function is provided for convenience.
It's equivalent to calling items(QPoint(x, y)).
Definition at line 295 of file qgraphicsview.h.
| QList< QGraphicsItem * > QGraphicsView::items | ( | const QRect & | rect, |
| Qt::ItemSelectionMode | mode = Qt::IntersectsItemShape |
||
| ) | const |
Returns a list of all the items that, depending on mode, are either contained by or intersect with rect.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
rect is in viewport coordinates.
The default value for mode is Qt::IntersectsItemShape; all items whose exact shape intersects with or is contained by rect are returned.
The items are sorted in descending stacking order (i.e., the first item in the returned list is the uppermost item).
Definition at line 2292 of file qgraphicsview.cpp.
|
inline |
This convenience function is equivalent to calling items(QRectF(x, y, w, h), mode).
Definition at line 297 of file qgraphicsview.h.
| QList< QGraphicsItem * > QGraphicsView::items | ( | const QPolygon & | polygon, |
| Qt::ItemSelectionMode | mode = Qt::IntersectsItemShape |
||
| ) | const |
Returns a list of all the items that, depending on mode, are either contained by or intersect with polygon.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
polygon is in viewport coordinates.
The default value for mode is Qt::IntersectsItemShape; all items whose exact shape intersects with or is contained by polygon are returned.
The items are sorted by descending stacking order (i.e., the first item in the returned list is the uppermost item).
Definition at line 2326 of file qgraphicsview.cpp.
| QList< QGraphicsItem * > QGraphicsView::items | ( | const QPainterPath & | path, |
| Qt::ItemSelectionMode | mode = Qt::IntersectsItemShape |
||
| ) | const |
Returns a list of all the items that, depending on mode, are either contained by or intersect with path.
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
path is in viewport coordinates.
The default value for mode is Qt::IntersectsItemShape; all items whose exact shape intersects with or is contained by path are returned.
Definition at line 2349 of file qgraphicsview.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3174 of file qgraphicsview.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3189 of file qgraphicsview.cpp.
Returns the scene coordinate point to viewport coordinates.
Definition at line 2491 of file qgraphicsview.cpp.
Referenced by QGraphicsItemPrivate::genericMapFromScene(), inputMethodQuery(), invalidateScene(), and mapFromScene().
Returns the scene rectangle rect to a viewport coordinate polygon.
Definition at line 2516 of file qgraphicsview.cpp.
Returns the scene coordinate polygon polygon to a viewport coordinate polygon.
Definition at line 2565 of file qgraphicsview.cpp.
| QPainterPath QGraphicsView::mapFromScene | ( | const QPainterPath & | path | ) | const |
Returns the scene coordinate painter path path to a viewport coordinate painter path.
Definition at line 2579 of file qgraphicsview.cpp.
This function is provided for convenience.
It's equivalent to calling mapFromScene(QPointF(x, y)).
Definition at line 305 of file qgraphicsview.h.
This function is provided for convenience.
It's equivalent to calling mapFromScene(QRectF(x, y, w, h)).
Definition at line 307 of file qgraphicsview.h.
Returns the viewport coordinate point mapped to scene coordinates.
Note: It can be useful to map the whole rectangle covered by the pixel at point instead of the point itself. To do this, you can call mapToScene(QRect(point, QSize(2, 2))).
Definition at line 2394 of file qgraphicsview.cpp.
Referenced by contextMenuEvent(), QGraphicsItem::isUnderMouse(), items(), QGraphicsScenePrivate::leaveScene(), QGestureEvent::mapToGraphicsScene(), mapToScene(), mouseDoubleClickEvent(), QmlJSDebugger::ZoomTool::mouseMoveEvent(), mouseMoveEvent(), QmlJSDebugger::ZoomTool::mousePressEvent(), mousePressEvent(), QmlJSDebugger::ZoomTool::mouseReleaseEvent(), mouseReleaseEvent(), paintEvent(), render(), QWidgetPrivate::screenGeometry(), QmlJSDebugger::SubcomponentMaskLayerItem::setCurrentItem(), viewportEvent(), and wheelEvent().
Returns the viewport rectangle rect mapped to a scene coordinate polygon.
Definition at line 2419 of file qgraphicsview.cpp.
Returns the viewport polygon polygon mapped to a scene coordinate polygon.
Definition at line 2464 of file qgraphicsview.cpp.
| QPainterPath QGraphicsView::mapToScene | ( | const QPainterPath & | path | ) | const |
Returns the viewport painter path path mapped to a scene coordinate painter path.
Definition at line 2478 of file qgraphicsview.cpp.
|
inline |
This function is provided for convenience.
It's equivalent to calling mapToScene(QPoint(x, y)).
Definition at line 301 of file qgraphicsview.h.
|
inline |
This function is provided for convenience.
It's equivalent to calling mapToScene(QRect(x, y, w, h)).
Definition at line 303 of file qgraphicsview.h.
| QMatrix QGraphicsView::matrix | ( | ) | const |
Returns the current transformation matrix for the view.
If no current transformation is set, the identity matrix is returned.
Definition at line 1769 of file qgraphicsview.cpp.
Referenced by mapFromScene(), mapToScene(), QGraphicsViewPrivate::mapToScene(), rotate(), scale(), setTransform(), shear(), and translate().
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3202 of file qgraphicsview.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3316 of file qgraphicsview.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3238 of file qgraphicsview.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3390 of file qgraphicsview.cpp.
| OptimizationFlags QGraphicsView::optimizationFlags | ( | ) | const |
Referenced by setViewportUpdateMode().
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3494 of file qgraphicsview.cpp.
Referenced by QDeclarativeView::paintEvent().
| void QGraphicsView::render | ( | QPainter * | painter, |
| const QRectF & | target = QRectF(), |
||
| const QRect & | source = QRect(), |
||
| Qt::AspectRatioMode | aspectRatioMode = Qt::KeepAspectRatio |
||
| ) |
Renders the source rect, which is in view coordinates, from the scene into target, which is in paint device coordinates, using painter.
This function is useful for capturing the contents of the view onto a paint device, such as a QImage (e.g., to take a screenshot), or for printing to QPrinter. For example:
If source is a null rect, this function will use viewport()->rect() to determine what to draw. If target is a null rect, the full dimensions of painter's paint device (e.g., for a QPrinter, the page size) will be used.
The source rect contents will be transformed according to aspectRatioMode to fit into the target rect. By default, the aspect ratio is kept, and source is scaled to fit in target.
Definition at line 2125 of file qgraphicsview.cpp.
Referenced by QmlJSDebugger::ColorPickerTool::pickColor().
| QPainter::RenderHints QGraphicsView::renderHints | ( | ) | const |
Referenced by sizeHint().
| void QGraphicsView::resetCachedContent | ( | ) |
Resets any cached content.
Calling this function will clear QGraphicsView's cache. If the current cache mode is CacheNone , this function does nothing.
This function is called automatically for you when the backgroundBrush or QGraphicsScene::backgroundBrush properties change; you only need to call this function if you have reimplemented QGraphicsScene::drawBackground() or QGraphicsView::drawBackground() to draw a custom background, and need to trigger a full redraw.
Definition at line 1566 of file qgraphicsview.cpp.
Referenced by QGraphicsScene::setBackgroundBrush(), and setCacheMode().
| void QGraphicsView::resetMatrix | ( | ) |
Resets the view transformation matrix to the identity matrix.
Definition at line 1811 of file qgraphicsview.cpp.
| void QGraphicsView::resetTransform | ( | ) |
Resets the view transformation to the identity matrix.
Definition at line 3953 of file qgraphicsview.cpp.
Referenced by resetMatrix().
| ViewportAnchor QGraphicsView::resizeAnchor | ( | ) | const |
Referenced by setTransformationAnchor().
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3663 of file qgraphicsview.cpp.
Referenced by QDeclarativeView::resizeEvent().
| void QGraphicsView::rotate | ( | qreal | angle | ) |
Rotates the current view transformation angle degrees clockwise.
Definition at line 1821 of file qgraphicsview.cpp.
| Qt::ItemSelectionMode QGraphicsView::rubberBandSelectionMode | ( | ) | const |
Referenced by setDragMode().
Scales the current view transformation by (sx, sy).
Definition at line 1834 of file qgraphicsview.cpp.
Referenced by fitInView(), and render().
| QGraphicsScene * QGraphicsView::scene | ( | ) | const |
Returns a pointer to the scene that is currently visualized in the view.
If no scene is currently visualized, 0 is returned.
Definition at line 1646 of file qgraphicsview.cpp.
Referenced by QDeclarativeView::paintEvent(), QmlJSDebugger::QDeclarativeViewInspector::QDeclarativeViewInspector(), QmlJSDebugger::AbstractLiveEditTool::scene(), QDeclarativeTextInputPrivate::sendMouseEventToInputContext(), and QDeclarativeView::setRootObject().
| QRectF QGraphicsView::sceneRect | ( | ) | const |
Referenced by fitInView(), setScene(), and sizeHint().
|
protectedvirtual |
Reimplemented Function
Reimplemented from QAbstractScrollArea.
Definition at line 3691 of file qgraphicsview.cpp.
| void QGraphicsView::setAlignment | ( | Qt::Alignment | alignment | ) |
Definition at line 1277 of file qgraphicsview.cpp.
| void QGraphicsView::setBackgroundBrush | ( | const QBrush & | brush | ) |
Definition at line 2629 of file qgraphicsview.cpp.
| void QGraphicsView::setCacheMode | ( | CacheMode | mode | ) |
Definition at line 1544 of file qgraphicsview.cpp.
| void QGraphicsView::setDragMode | ( | DragMode | mode | ) |
Definition at line 1458 of file qgraphicsview.cpp.
| void QGraphicsView::setForegroundBrush | ( | const QBrush & | brush | ) |
Definition at line 2662 of file qgraphicsview.cpp.
| void QGraphicsView::setInteractive | ( | bool | allowed | ) |
Definition at line 1634 of file qgraphicsview.cpp.
| void QGraphicsView::setMatrix | ( | const QMatrix & | matrix, |
| bool | combine = false |
||
| ) |
Sets the view's current transformation matrix to matrix.
If combine is true, then matrix is combined with the current matrix; otherwise, matrix replaces the current matrix. combine is false by default.
The transformation matrix tranforms the scene into view coordinates. Using the default transformation, provided by the identity matrix, one pixel in the view represents one unit in the scene (e.g., a 10x10 rectangular item is drawn using 10x10 pixels in the view). If a 2x2 scaling matrix is applied, the scene will be drawn in 1:2 (e.g., a 10x10 rectangular item is then drawn using 20x20 pixels in the view).
Example:
To simplify interation with items using a transformed view, QGraphicsView provides mapTo... and mapFrom... functions that can translate between scene and view coordinates. For example, you can call mapToScene() to map a view coordinate to a floating point scene coordinate, or mapFromScene() to map from floating point scene coordinates to view coordinates.
Definition at line 1801 of file qgraphicsview.cpp.
| void QGraphicsView::setOptimizationFlag | ( | OptimizationFlag | flag, |
| bool | enabled = true |
||
| ) |
Enables flag if enabled is true; otherwise disables flag.
Definition at line 1427 of file qgraphicsview.cpp.
| void QGraphicsView::setOptimizationFlags | ( | OptimizationFlags | flags | ) |
Definition at line 1416 of file qgraphicsview.cpp.
| void QGraphicsView::setRenderHint | ( | QPainter::RenderHint | hint, |
| bool | enabled = true |
||
| ) |
If enabled is true, the render hint hint is enabled; otherwise it is disabled.
Definition at line 1245 of file qgraphicsview.cpp.
| void QGraphicsView::setRenderHints | ( | QPainter::RenderHints | hints | ) |
Definition at line 1230 of file qgraphicsview.cpp.
| void QGraphicsView::setResizeAnchor | ( | ViewportAnchor | anchor | ) |
Definition at line 1347 of file qgraphicsview.cpp.
| void QGraphicsView::setRubberBandSelectionMode | ( | Qt::ItemSelectionMode | mode | ) |
Definition at line 1509 of file qgraphicsview.cpp.
| void QGraphicsView::setScene | ( | QGraphicsScene * | scene | ) |
Sets the current scene to scene.
If scene is already being viewed, this function does nothing.
When a scene is set on a view, the QGraphicsScene::changed() signal is automatically connected to this view's updateScene() slot, and the view's scroll bars are adjusted to fit the size of the scene.
Definition at line 1660 of file qgraphicsview.cpp.
Referenced by QGraphicsView().
| void QGraphicsView::setSceneRect | ( | const QRectF & | rect | ) |
Definition at line 1755 of file qgraphicsview.cpp.
Referenced by QmlJSDebugger::ZoomTool::mouseReleaseEvent(), QDeclarativeView::resizeEvent(), and QmlJSDebugger::ZoomTool::scaleView().
Definition at line 287 of file qgraphicsview.h.
| void QGraphicsView::setTransform | ( | const QTransform & | matrix, |
| bool | combine = false |
||
| ) |
Sets the view's current transformation matrix to matrix.
If combine is true, then matrix is combined with the current matrix; otherwise, matrix replaces the current matrix. combine is false by default.
The transformation matrix tranforms the scene into view coordinates. Using the default transformation, provided by the identity matrix, one pixel in the view represents one unit in the scene (e.g., a 10x10 rectangular item is drawn using 10x10 pixels in the view). If a 2x2 scaling matrix is applied, the scene will be drawn in 1:2 (e.g., a 10x10 rectangular item is then drawn using 20x20 pixels in the view).
Example:
To simplify interation with items using a transformed view, QGraphicsView provides mapTo... and mapFrom... functions that can translate between scene and view coordinates. For example, you can call mapToScene() to map a view coordiate to a floating point scene coordinate, or mapFromScene() to map from floating point scene coordinates to view coordinates.
Definition at line 3920 of file qgraphicsview.cpp.
Referenced by QmlJSDebugger::ZoomTool::mouseReleaseEvent(), resetTransform(), rotate(), scale(), QmlJSDebugger::ZoomTool::scaleView(), setMatrix(), shear(), and translate().
| void QGraphicsView::setTransformationAnchor | ( | ViewportAnchor | anchor | ) |
Definition at line 1312 of file qgraphicsview.cpp.
|
protectedslot |
This slot is called by QAbstractScrollArea after setViewport() has been called.
Reimplement this function in a subclass of QGraphicsView to initialize the new viewport widget before it is used.
Definition at line 2766 of file qgraphicsview.cpp.
| void QGraphicsView::setViewportUpdateMode | ( | ViewportUpdateMode | mode | ) |
Definition at line 1384 of file qgraphicsview.cpp.
Shears the current view transformation by (sh, sv).
Definition at line 1847 of file qgraphicsview.cpp.
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3748 of file qgraphicsview.cpp.
|
virtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 1196 of file qgraphicsview.cpp.
| QTransform QGraphicsView::transform | ( | ) | const |
Returns the current transformation matrix for the view.
If no current transformation is set, the identity matrix is returned.
Definition at line 3859 of file qgraphicsview.cpp.
Referenced by paintEvent(), and updateScene().
| ViewportAnchor QGraphicsView::transformationAnchor | ( | ) | const |
Referenced by setAlignment().
Translates the current view transformation by (dx, dy).
Definition at line 1860 of file qgraphicsview.cpp.
Schedules an update of the scene rectangles rects.
Definition at line 2674 of file qgraphicsview.cpp.
Referenced by setScene(), and viewportEvent().
|
slot |
Notifies QGraphicsView that the scene's scene rect has changed.
rect is the new scene rect. If the view already has an explicitly set scene rect, this function does nothing.
Definition at line 2750 of file qgraphicsview.cpp.
Referenced by setScene().
|
protectedvirtual |
Reimplemented Function
Reimplemented from QAbstractScrollArea.
Definition at line 2854 of file qgraphicsview.cpp.
| QTransform QGraphicsView::viewportTransform | ( | ) | const |
Returns a matrix that maps viewport coordinates to scene coordinates.
Definition at line 3870 of file qgraphicsview.cpp.
Referenced by QGraphicsItemPrivate::genericMapFromScene(), QGraphicsScenePrivate::gestureEventHandler(), items(), QGraphicsScenePrivate::itemsAtPosition(), mouseMoveEvent(), QGraphicsItem::mouseMoveEvent(), paintEvent(), QGraphicsScene::update(), updateHelper(), and updateScene().
| ViewportUpdateMode QGraphicsView::viewportUpdateMode | ( | ) | const |
Referenced by setResizeAnchor().
|
protectedvirtual |
Reimplemented Function
Reimplemented from QWidget.
Definition at line 3465 of file qgraphicsview.cpp.
|
friend |
Definition at line 281 of file qgraphicsview.h.
|
friend |
Definition at line 279 of file qgraphicsview.h.
|
friend |
Definition at line 280 of file qgraphicsview.h.
|
friend |
Definition at line 278 of file qgraphicsview.h.
|
private |
the alignment of the scene in the view when the whole scene is visible.
If the whole scene is visible in the view, (i.e., there are no visible scroll bars,) the view's alignment will decide where the scene will be rendered in the view. For example, if the alignment is Qt::AlignCenter, which is default, the scene will be centered in the view, and if the alignment is (Qt::AlignLeft | Qt::AlignTop), the scene will be rendered in the top-left corner of the view.
Definition at line 73 of file qgraphicsview.h.
|
private |
the background brush of the scene.
This property sets the background brush for the scene in this view. It is used to override the scene's own background, and defines the behavior of drawBackground(). To provide custom background drawing for this view, you can reimplement drawBackground() instead.
By default, this property contains a brush with the Qt::NoBrush pattern.
Definition at line 69 of file qgraphicsview.h.
|
private |
which parts of the view are cached
QGraphicsView can cache pre-rendered content in a QPixmap, which is then drawn onto the viewport. The purpose of such caching is to speed up the total rendering time for areas that are slow to render. Texture, gradient and alpha blended backgrounds, for example, can be notibly slow to render; especially with a transformed view. The CacheBackground flag enables caching of the view's background. For example:
The cache is invalidated every time the view is transformed. However, when scrolling, only partial invalidation is required.
By default, nothing is cached.
Definition at line 76 of file qgraphicsview.h.
|
private |
the behavior for dragging the mouse over the scene while the left mouse button is pressed.
This property defines what should happen when the user clicks on the scene background and drags the mouse (e.g., scrolling the viewport contents using a pointing hand cursor, or selecting multiple items with a rubber band). The default value, NoDrag, does nothing.
This behavior only affects mouse clicks that are not handled by any item. You can define a custom behavior by creating a subclass of QGraphicsView and reimplementing mouseMoveEvent().
Definition at line 75 of file qgraphicsview.h.
|
private |
the foreground brush of the scene.
This property sets the foreground brush for the scene in this view. It is used to override the scene's own foreground, and defines the behavior of drawForeground(). To provide custom foreground drawing for this view, you can reimplement drawForeground() instead.
By default, this property contains a brush with the Qt::NoBrush pattern.
Definition at line 70 of file qgraphicsview.h.
|
private |
whether the view allowed scene interaction.
If enabled, this view is set to allow scene interaction. Otherwise, this view will not allow interaction, and any mouse or key events are ignored (i.e., it will act as a read-only view).
By default, this property is true.
Definition at line 71 of file qgraphicsview.h.
|
private |
flags that can be used to tune QGraphicsView's performance.
QGraphicsView uses clipping, extra bounding rect adjustments, and certain other aids to improve rendering quality and performance for the common case graphics scene. However, depending on the target platform, the scene, and the viewport in use, some of these operations can degrade performance.
The effect varies from flag to flag; see the OptimizationFlags documentation for details.
By default, no optimization flags are enabled.
Definition at line 83 of file qgraphicsview.h.
Referenced by QGraphicsScene::drawItems().
|
private |
the default render hints for the view
These hints are used to initialize QPainter before each visible item is drawn. QPainter uses render hints to toggle rendering features such as antialiasing and smooth pixmap transformation.
QPainter::TextAntialiasing is enabled by default.
Example:
Definition at line 74 of file qgraphicsview.h.
|
private |
how the view should position the scene when the view is resized.
QGraphicsView uses this property to decide how to position the scene in the viewport when the viewport widget's size changes. The default behavior, NoAnchor, leaves the scene's position unchanged during a resize; the top-left corner of the view will appear to be anchored while resizing.
Note that the effect of this property is noticeable when only a part of the scene is visible (i.e., when there are scroll bars). Otherwise, if the whole scene fits in the view, QGraphicsScene uses the view alignment to position the scene in the view.
Definition at line 78 of file qgraphicsview.h.
|
private |
the behavior for selecting items with a rubber band selection rectangle.
This property defines how items are selected when using the RubberBandDrag drag mode.
The default value is Qt::IntersectsItemShape; all items whose shape intersects with or is contained by the rubber band are selected.
Definition at line 81 of file qgraphicsview.h.
|
private |
the area of the scene visualized by this view.
The scene rectangle defines the extent of the scene, and in the view's case, this means the area of the scene that you can navigate using the scroll bars.
If unset, or if a null QRectF is set, this property has the same value as QGraphicsScene::sceneRect, and it changes with QGraphicsScene::sceneRect. Otherwise, the view's scene rect is unaffected by the scene.
Note that, although the scene supports a virtually unlimited size, the range of the scroll bars will never exceed the range of an integer (INT_MIN, INT_MAX). When the scene is larger than the scroll bars' values, you can choose to use translate() to navigate the scene instead.
By default, this property contains a rectangle at the origin with zero width and height.
Definition at line 72 of file qgraphicsview.h.
|
private |
how the view should position the scene during transformations.
QGraphicsView uses this property to decide how to position the scene in the viewport when the transformation matrix changes, and the coordinate system of the view is transformed. The default behavior, AnchorViewCenter, ensures that the scene point at the center of the view remains unchanged during transformations (e.g., when rotating, the scene will appear to rotate around the center of the view).
Note that the effect of this property is noticeable when only a part of the scene is visible (i.e., when there are scroll bars). Otherwise, if the whole scene fits in the view, QGraphicsScene uses the view alignment to position the scene in the view.
Definition at line 77 of file qgraphicsview.h.
|
private |
how the viewport should update its contents.
QGraphicsView uses this property to decide how to update areas of the scene that have been reexposed or changed. Usually you do not need to modify this property, but there are some cases where doing so can improve rendering performance. See the ViewportUpdateMode documentation for specific details.
The default value is MinimalViewportUpdate, where QGraphicsView will update as small an area of the viewport as possible when the contents change.
Definition at line 79 of file qgraphicsview.h.
Referenced by QGLGraphicsSystem::createWindowSurface().