/****************************************************************************

**

** 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$

** No Commercial Usage

** This file contains pre-release code and may not be distributed.

** You may use this file in accordance with the terms and conditions

** contained in the Technology Preview License Agreement accompanying

** this package.

**

** 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.

**

** 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