You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
317 lines
12 KiB
317 lines
12 KiB
14 years ago
|
/****************************************************************************
|
||
|
|
**
|
||
|
|
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
|
||
|
|
** All rights reserved.
|
||
|
|
** Contact: Nokia Corporation (qt-info@nokia.com)
|
||
|
|
**
|
||
|
|
** This file is part of the QtGui module of the Qt Toolkit.
|
||
|
|
**
|
||
|
|
** $QT_BEGIN_LICENSE:LGPL$
|
||
|
|
** Commercial Usage
|
||
|
|
** Licensees holding valid Qt Commercial licenses may use this file in
|
||
|
|
** accordance with the Qt Commercial License Agreement provided with the
|
||
|
|
** Software or, alternatively, in accordance with the terms contained in
|
||
|
|
** a written agreement between you and Nokia.
|
||
|
|
**
|
||
|
|
** GNU Lesser General Public License Usage
|
||
|
|
** Alternatively, this file may be used under the terms of the GNU Lesser
|
||
|
|
** General Public License version 2.1 as published by the Free Software
|
||
|
|
** Foundation and appearing in the file LICENSE.LGPL included in the
|
||
|
|
** packaging of this file. Please review the following information to
|
||
|
|
** ensure the GNU Lesser General Public License version 2.1 requirements
|
||
|
|
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
|
||
|
|
**
|
||
|
|
** In addition, as a special exception, Nokia gives you certain additional
|
||
|
|
** rights. These rights are described in the Nokia Qt LGPL Exception
|
||
|
|
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
|
||
|
|
**
|
||
|
|
** GNU General Public License Usage
|
||
|
|
** Alternatively, this file may be used under the terms of the GNU
|
||
|
|
** General Public License version 3.0 as published by the Free Software
|
||
|
|
** Foundation and appearing in the file LICENSE.GPL included in the
|
||
|
|
** packaging of this file. Please review the following information to
|
||
|
|
** ensure the GNU General Public License version 3.0 requirements will be
|
||
|
|
** met: http://www.gnu.org/copyleft/gpl.html.
|
||
|
|
**
|
||
|
|
** If you have questions regarding the use of this file, please contact
|
||
|
|
** Nokia at qt-info@nokia.com.
|
||
|
|
** $QT_END_LICENSE$
|
||
|
|
**
|
||
|
|
****************************************************************************/
|
||
|
|
|
||
|
|
#ifndef QGRAPHICSVIEW_H
|
||
|
|
#define QGRAPHICSVIEW_H
|
||
|
|
|
||
|
|
#include <QtCore/qmetatype.h>
|
||
|
|
#include <QtGui/qpainter.h>
|
||
|
|
#include <QtGui/qscrollarea.h>
|
||
|
|
#include <QtGui/qgraphicsscene.h>
|
||
|
|
|
||
|
|
QT_BEGIN_HEADER
|
||
|
|
|
||
|
|
QT_BEGIN_NAMESPACE
|
||
|
|
|
||
|
|
QT_MODULE(Gui)
|
||
|
|
|
||
|
|
#if !defined(QT_NO_GRAPHICSVIEW) || (QT_EDITION & QT_MODULE_GRAPHICSVIEW) != QT_MODULE_GRAPHICSVIEW
|
||
|
|
|
||
|
|
class QGraphicsItem;
|
||
|
|
class QPainterPath;
|
||
|
|
class QPolygonF;
|
||
|
|
class QStyleOptionGraphicsItem;
|
||
|
|
|
||
|
|
class QGraphicsViewPrivate;
|
||
|
|
class Q_GUI_EXPORT QGraphicsView : public QAbstractScrollArea
|
||
|
|
{
|
||
|
|
Q_OBJECT
|
||
|
|
Q_FLAGS(QPainter::RenderHints CacheMode OptimizationFlags)
|
||
|
|
Q_ENUMS(ViewportAnchor DragMode ViewportUpdateMode)
|
||
|
|
Q_PROPERTY(QBrush backgroundBrush READ backgroundBrush WRITE setBackgroundBrush)
|
||
|
|
Q_PROPERTY(QBrush foregroundBrush READ foregroundBrush WRITE setForegroundBrush)
|
||
|
|
Q_PROPERTY(bool interactive READ isInteractive WRITE setInteractive)
|
||
|
|
Q_PROPERTY(QRectF sceneRect READ sceneRect WRITE setSceneRect)
|
||
|
|
Q_PROPERTY(Qt::Alignment alignment READ alignment WRITE setAlignment)
|
||
|
|
Q_PROPERTY(QPainter::RenderHints renderHints READ renderHints WRITE setRenderHints)
|
||
|
|
Q_PROPERTY(DragMode dragMode READ dragMode WRITE setDragMode)
|
||
|
|
Q_PROPERTY(CacheMode cacheMode READ cacheMode WRITE setCacheMode)
|
||
|
|
Q_PROPERTY(ViewportAnchor transformationAnchor READ transformationAnchor WRITE setTransformationAnchor)
|
||
|
|
Q_PROPERTY(ViewportAnchor resizeAnchor READ resizeAnchor WRITE setResizeAnchor)
|
||
|
|
Q_PROPERTY(ViewportUpdateMode viewportUpdateMode READ viewportUpdateMode WRITE setViewportUpdateMode)
|
||
|
|
#ifndef QT_NO_RUBBERBAND
|
||
|
|
Q_PROPERTY(Qt::ItemSelectionMode rubberBandSelectionMode READ rubberBandSelectionMode WRITE setRubberBandSelectionMode)
|
||
|
|
#endif
|
||
|
|
Q_PROPERTY(OptimizationFlags optimizationFlags READ optimizationFlags WRITE setOptimizationFlags)
|
||
|
|
|
||
|
|
public:
|
||
|
|
enum ViewportAnchor {
|
||
|
|
NoAnchor,
|
||
|
|
AnchorViewCenter,
|
||
|
|
AnchorUnderMouse
|
||
|
|
};
|
||
|
|
|
||
|
|
enum CacheModeFlag {
|
||
|
|
CacheNone = 0x0,
|
||
|
|
CacheBackground = 0x1
|
||
|
|
};
|
||
|
|
Q_DECLARE_FLAGS(CacheMode, CacheModeFlag)
|
||
|
|
|
||
|
|
enum DragMode {
|
||
|
|
NoDrag,
|
||
|
|
ScrollHandDrag,
|
||
|
|
RubberBandDrag
|
||
|
|
};
|
||
|
|
|
||
|
|
enum ViewportUpdateMode {
|
||
|
|
FullViewportUpdate,
|
||
|
|
MinimalViewportUpdate,
|
||
|
|
SmartViewportUpdate,
|
||
|
|
NoViewportUpdate,
|
||
|
|
BoundingRectViewportUpdate
|
||
|
|
};
|
||
|
|
|
||
|
|
enum OptimizationFlag {
|
||
|
|
DontClipPainter = 0x1, // obsolete
|
||
|
|
DontSavePainterState = 0x2,
|
||
|
|
DontAdjustForAntialiasing = 0x4,
|
||
|
|
IndirectPainting = 0x8
|
||
|
|
};
|
||
|
|
Q_DECLARE_FLAGS(OptimizationFlags, OptimizationFlag)
|
||
|
|
|
||
|
|
QGraphicsView(QWidget *parent = 0);
|
||
|
|
QGraphicsView(QGraphicsScene *scene, QWidget *parent = 0);
|
||
|
|
~QGraphicsView();
|
||
|
|
|
||
|
|
QSize sizeHint() const;
|
||
|
|
|
||
|
|
QPainter::RenderHints renderHints() const;
|
||
|
|
void setRenderHint(QPainter::RenderHint hint, bool enabled = true);
|
||
|
|
void setRenderHints(QPainter::RenderHints hints);
|
||
|
|
|
||
|
|
Qt::Alignment alignment() const;
|
||
|
|
void setAlignment(Qt::Alignment alignment);
|
||
|
|
|
||
|
|
ViewportAnchor transformationAnchor() const;
|
||
|
|
void setTransformationAnchor(ViewportAnchor anchor);
|
||
|
|
|
||
|
|
ViewportAnchor resizeAnchor() const;
|
||
|
|
void setResizeAnchor(ViewportAnchor anchor);
|
||
|
|
|
||
|
|
ViewportUpdateMode viewportUpdateMode() const;
|
||
|
|
void setViewportUpdateMode(ViewportUpdateMode mode);
|
||
|
|
|
||
|
|
OptimizationFlags optimizationFlags() const;
|
||
|
|
void setOptimizationFlag(OptimizationFlag flag, bool enabled = true);
|
||
|
|
void setOptimizationFlags(OptimizationFlags flags);
|
||
|
|
|
||
|
|
DragMode dragMode() const;
|
||
|
|
void setDragMode(DragMode mode);
|
||
|
|
|
||
|
|
#ifndef QT_NO_RUBBERBAND
|
||
|
|
Qt::ItemSelectionMode rubberBandSelectionMode() const;
|
||
|
|
void setRubberBandSelectionMode(Qt::ItemSelectionMode mode);
|
||
|
|
#endif
|
||
|
|
|
||
|
|
CacheMode cacheMode() const;
|
||
|
|
void setCacheMode(CacheMode mode);
|
||
|
|
void resetCachedContent();
|
||
|
|
|
||
|
|
bool isInteractive() const;
|
||
|
|
void setInteractive(bool allowed);
|
||
|
|
|
||
|
|
QGraphicsScene *scene() const;
|
||
|
|
void setScene(QGraphicsScene *scene);
|
||
|
|
|
||
|
|
QRectF sceneRect() const;
|
||
|
|
void setSceneRect(const QRectF &rect);
|
||
|
|
inline void setSceneRect(qreal x, qreal y, qreal w, qreal h);
|
||
|
|
|
||
|
|
QMatrix matrix() const;
|
||
|
|
void setMatrix(const QMatrix &matrix, bool combine = false);
|
||
|
|
void resetMatrix();
|
||
|
|
QTransform transform() const;
|
||
|
|
QTransform viewportTransform() const;
|
||
|
|
bool isTransformed() const;
|
||
|
|
void setTransform(const QTransform &matrix, bool combine = false);
|
||
|
|
void resetTransform();
|
||
|
|
void rotate(qreal angle);
|
||
|
|
void scale(qreal sx, qreal sy);
|
||
|
|
void shear(qreal sh, qreal sv);
|
||
|
|
void translate(qreal dx, qreal dy);
|
||
|
|
|
||
|
|
void centerOn(const QPointF &pos);
|
||
|
|
inline void centerOn(qreal x, qreal y);
|
||
|
|
void centerOn(const QGraphicsItem *item);
|
||
|
|
void ensureVisible(const QRectF &rect, int xmargin = 50, int ymargin = 50);
|
||
|
|
inline void ensureVisible(qreal x, qreal y, qreal w, qreal h, int xmargin = 50, int ymargin = 50);
|
||
|
|
void ensureVisible(const QGraphicsItem *item, int xmargin = 50, int ymargin = 50);
|
||
|
|
void fitInView(const QRectF &rect, Qt::AspectRatioMode aspectRadioMode = Qt::IgnoreAspectRatio);
|
||
|
|
inline 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);
|
||
|
|
|
||
|
|
void render(QPainter *painter, const QRectF &target = QRectF(), const QRect &source = QRect(),
|
||
|
|
Qt::AspectRatioMode aspectRatioMode = Qt::KeepAspectRatio);
|
||
|
|
|
||
|
|
QList<QGraphicsItem *> items() const;
|
||
|
|
QList<QGraphicsItem *> items(const QPoint &pos) const;
|
||
|
|
inline QList<QGraphicsItem *> items(int x, int y) const;
|
||
|
|
QList<QGraphicsItem *> items(const QRect &rect, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const;
|
||
|
|
inline 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;
|
||
|
|
QList<QGraphicsItem *> items(const QPainterPath &path, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const;
|
||
|
|
QGraphicsItem *itemAt(const QPoint &pos) const;
|
||
|
|
inline QGraphicsItem *itemAt(int x, int y) const;
|
||
|
|
|
||
|
|
QPointF mapToScene(const QPoint &point) const;
|
||
|
|
QPolygonF mapToScene(const QRect &rect) const;
|
||
|
|
QPolygonF mapToScene(const QPolygon &polygon) const;
|
||
|
|
QPainterPath mapToScene(const QPainterPath &path) const;
|
||
|
|
QPoint mapFromScene(const QPointF &point) const;
|
||
|
|
QPolygon mapFromScene(const QRectF &rect) const;
|
||
|
|
QPolygon mapFromScene(const QPolygonF &polygon) const;
|
||
|
|
QPainterPath mapFromScene(const QPainterPath &path) const;
|
||
|
|
inline QPointF mapToScene(int x, int y) const;
|
||
|
|
inline QPolygonF mapToScene(int x, int y, int w, int h) const;
|
||
|
|
inline QPoint mapFromScene(qreal x, qreal y) const;
|
||
|
|
inline QPolygon mapFromScene(qreal x, qreal y, qreal w, qreal h) const;
|
||
|
|
|
||
|
|
QVariant inputMethodQuery(Qt::InputMethodQuery query) const;
|
||
|
|
|
||
|
|
QBrush backgroundBrush() const;
|
||
|
|
void setBackgroundBrush(const QBrush &brush);
|
||
|
|
|
||
|
|
QBrush foregroundBrush() const;
|
||
|
|
void setForegroundBrush(const QBrush &brush);
|
||
|
|
|
||
|
|
public Q_SLOTS:
|
||
|
|
void updateScene(const QList<QRectF> &rects);
|
||
|
|
void invalidateScene(const QRectF &rect = QRectF(), QGraphicsScene::SceneLayers layers = QGraphicsScene::AllLayers);
|
||
|
|
void updateSceneRect(const QRectF &rect);
|
||
|
|
|
||
|
|
protected Q_SLOTS:
|
||
|
|
void setupViewport(QWidget *widget);
|
||
|
|
|
||
|
|
protected:
|
||
|
|
QGraphicsView(QGraphicsViewPrivate &, QWidget *parent = 0);
|
||
|
|
bool event(QEvent *event);
|
||
|
|
bool viewportEvent(QEvent *event);
|
||
|
|
|
||
|
|
#ifndef QT_NO_CONTEXTMENU
|
||
|
|
void contextMenuEvent(QContextMenuEvent *event);
|
||
|
|
#endif
|
||
|
|
void dragEnterEvent(QDragEnterEvent *event);
|
||
|
|
void dragLeaveEvent(QDragLeaveEvent *event);
|
||
|
|
void dragMoveEvent(QDragMoveEvent *event);
|
||
|
|
void dropEvent(QDropEvent *event);
|
||
|
|
void focusInEvent(QFocusEvent *event);
|
||
|
|
bool focusNextPrevChild(bool next);
|
||
|
|
void focusOutEvent(QFocusEvent *event);
|
||
|
|
void keyPressEvent(QKeyEvent *event);
|
||
|
|
void keyReleaseEvent(QKeyEvent *event);
|
||
|
|
void mouseDoubleClickEvent(QMouseEvent *event);
|
||
|
|
void mousePressEvent(QMouseEvent *event);
|
||
|
|
void mouseMoveEvent(QMouseEvent *event);
|
||
|
|
void mouseReleaseEvent(QMouseEvent *event);
|
||
|
|
#ifndef QT_NO_WHEELEVENT
|
||
|
|
void wheelEvent(QWheelEvent *event);
|
||
|
|
#endif
|
||
|
|
void paintEvent(QPaintEvent *event);
|
||
|
|
void resizeEvent(QResizeEvent *event);
|
||
|
|
void scrollContentsBy(int dx, int dy);
|
||
|
|
void showEvent(QShowEvent *event);
|
||
|
|
void inputMethodEvent(QInputMethodEvent *event);
|
||
|
|
|
||
|
|
virtual void drawBackground(QPainter *painter, const QRectF &rect);
|
||
|
|
virtual void drawForeground(QPainter *painter, const QRectF &rect);
|
||
|
|
virtual void drawItems(QPainter *painter, int numItems,
|
||
|
|
QGraphicsItem *items[],
|
||
|
|
const QStyleOptionGraphicsItem options[]);
|
||
|
|
|
||
|
|
private:
|
||
|
|
Q_DECLARE_PRIVATE(QGraphicsView)
|
||
|
|
Q_DISABLE_COPY(QGraphicsView)
|
||
|
|
#ifndef QT_NO_CURSOR
|
||
|
|
Q_PRIVATE_SLOT(d_func(), void _q_setViewportCursor(const QCursor &))
|
||
|
|
Q_PRIVATE_SLOT(d_func(), void _q_unsetViewportCursor())
|
||
|
|
#endif
|
||
|
|
friend class QGraphicsSceneWidget;
|
||
|
|
friend class QGraphicsScene;
|
||
|
|
friend class QGraphicsScenePrivate;
|
||
|
|
friend class QGraphicsItemPrivate;
|
||
|
|
};
|
||
|
|
|
||
|
|
Q_DECLARE_OPERATORS_FOR_FLAGS(QGraphicsView::CacheMode)
|
||
|
|
Q_DECLARE_OPERATORS_FOR_FLAGS(QGraphicsView::OptimizationFlags)
|
||
|
|
|
||
|
|
inline void QGraphicsView::setSceneRect(qreal ax, qreal ay, qreal aw, qreal ah)
|
||
|
|
{ setSceneRect(QRectF(ax, ay, aw, ah)); }
|
||
|
|
inline void QGraphicsView::centerOn(qreal ax, qreal ay)
|
||
|
|
{ centerOn(QPointF(ax, ay)); }
|
||
|
|
inline void QGraphicsView::ensureVisible(qreal ax, qreal ay, qreal aw, qreal ah, int xmargin, int ymargin)
|
||
|
|
{ ensureVisible(QRectF(ax, ay, aw, ah), xmargin, ymargin); }
|
||
|
|
inline void QGraphicsView::fitInView(qreal ax, qreal ay, qreal w, qreal h, Qt::AspectRatioMode mode)
|
||
|
|
{ fitInView(QRectF(ax, ay, w, h), mode); }
|
||
|
|
inline QList<QGraphicsItem *> QGraphicsView::items(int ax, int ay) const
|
||
|
|
{ return items(QPoint(ax, ay)); }
|
||
|
|
inline QList<QGraphicsItem *> QGraphicsView::items(int ax, int ay, int w, int h, Qt::ItemSelectionMode mode) const
|
||
|
|
{ return items(QRect(ax, ay, w, h), mode); }
|
||
|
|
inline QGraphicsItem *QGraphicsView::itemAt(int ax, int ay) const
|
||
|
|
{ return itemAt(QPoint(ax, ay)); }
|
||
|
|
inline QPointF QGraphicsView::mapToScene(int ax, int ay) const
|
||
|
|
{ return mapToScene(QPoint(ax, ay)); }
|
||
|
|
inline QPolygonF QGraphicsView::mapToScene(int ax, int ay, int w, int h) const
|
||
|
|
{ return mapToScene(QRect(ax, ay, w, h)); }
|
||
|
|
inline QPoint QGraphicsView::mapFromScene(qreal ax, qreal ay) const
|
||
|
|
{ return mapFromScene(QPointF(ax, ay)); }
|
||
|
|
inline QPolygon QGraphicsView::mapFromScene(qreal ax, qreal ay, qreal w, qreal h) const
|
||
|
|
{ return mapFromScene(QRectF(ax, ay, w, h)); }
|
||
|
|
|
||
|
|
#endif // QT_NO_GRAPHICSVIEW
|
||
|
|
|
||
|
|
QT_END_NAMESPACE
|
||
|
|
|
||
|
|
QT_END_HEADER
|
||
|
|
|
||
|
|
#endif // QGRAPHICSVIEW_H
|