qgscomposerview.h

Go to the documentation of this file.

/***************************************************************************
                         qgscomposerview.h
                             -------------------
    begin                : January 2005
    copyright            : (C) 2005 by Radim Blazek
    email                : [email protected]
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
#ifndef QGSCOMPOSERVIEW_H
#define QGSCOMPOSERVIEW_H

#include <QGraphicsView>
#include "qgsaddremoveitemcommand.h"
#include "qgsprevieweffect.h" // for QgsPreviewEffect::PreviewMode

class QDomDocument;
class QDomElement;
class QKeyEvent;
class QMainWindow;
class QMouseEvent;
class QgsComposition;
class QgsComposerArrow;
class QgsComposerItem;
class QgsComposerLabel;
class QgsComposerLegend;
class QgsComposerMap;
class QgsComposerPicture;
class QgsComposerRuler;
class QgsComposerScaleBar;
class QgsComposerShape;
class QgsComposerAttributeTableV2;

class GUI_EXPORT QgsComposerView: public QGraphicsView
{
    Q_OBJECT

  public:

    enum Tool
    {
      Select = 0,      // Select/Move item
      AddArrow,         //add arrow
      AddHtml,
      AddMap,          // add new map
      AddLegend, // add vector legend
      AddLabel,        // add label
      AddScalebar,     // add scalebar
      AddPicture,       // add raster/vector picture
      AddRectangle,
      AddEllipse,
      AddTriangle,
      AddTable, //add table
      AddAttributeTable,
      MoveItemContent, //move content of item (e.g. content of map)
      Pan,
      Zoom
    };

    enum ClipboardMode
    {
      ClipboardModeCut,
      ClipboardModeCopy
    };

    enum PasteMode
    {
      PasteModeCursor,
      PasteModeCenter,
      PasteModeInPlace
    };

    enum ToolStatus
    {
      Inactive,
      Active,
      ActiveUntilMouseRelease
    };

    QgsComposerView( QWidget* parent = 0, const char* name = 0, Qt::WindowFlags f = 0 );

    void groupItems();

    void ungroupItems();

    void copyItems( ClipboardMode mode );

    void pasteItems( PasteMode mode );

    void deleteSelectedItems();

    void selectAll();

    void selectNone();

    void selectInvert();

    QgsComposerView::Tool currentTool() const {return mCurrentTool;}
    void setCurrentTool( QgsComposerView::Tool t );

    void setComposition( QgsComposition* c );

    QgsComposition* composition();

    QMainWindow* composerWindow();

    void setPaintingEnabled( bool enabled ) { mPaintingEnabled = enabled; }
    bool paintingEnabled() const { return mPaintingEnabled; }

    void updateRulers();

    void setHorizontalRuler( QgsComposerRuler* r ) { mHorizontalRuler = r; }
    void setVerticalRuler( QgsComposerRuler* r ) { mVerticalRuler = r; }

    void setZoomLevel( double zoomLevel );

    void setPreviewModeEnabled( bool enabled );
    void setPreviewMode( QgsPreviewEffect::PreviewMode mode );

  protected:
    void mousePressEvent( QMouseEvent* );
    void mouseReleaseEvent( QMouseEvent* );
    void mouseMoveEvent( QMouseEvent* );
    void mouseDoubleClickEvent( QMouseEvent* e );

    void keyPressEvent( QKeyEvent * e );
    void keyReleaseEvent( QKeyEvent * e );

    void wheelEvent( QWheelEvent* event );

    void paintEvent( QPaintEvent* event );

    void hideEvent( QHideEvent* e );
    void showEvent( QShowEvent* e );

    void resizeEvent( QResizeEvent* event );
    void scrollContentsBy( int dx, int dy );

  private:
    QgsComposerView::Tool mCurrentTool;
    QgsComposerView::Tool mPreviousTool;

    QGraphicsRectItem* mRubberBandItem;
    QGraphicsLineItem* mRubberBandLineItem;
    QgsComposerItem* mMoveContentItem;
    QPointF mMoveContentStartPos;
    QPointF mRubberBandStartPos;

    bool mMarqueeSelect;
    bool mMarqueeZoom;
    QgsComposerView::ToolStatus mTemporaryZoomStatus;

    bool mPaintingEnabled;

    QgsComposerRuler* mHorizontalRuler;
    QgsComposerRuler* mVerticalRuler;

    void addShape( Tool currentTool );

    bool mToolPanning;
    bool mMousePanning;
    bool mKeyPanning;

    bool mMovingItemContent;

    QPoint mMouseLastXY;
    QPoint mMouseCurrentXY;
    QPoint mMousePressStartPos;

    QgsPreviewEffect* mPreviewEffect;

    QCursor defaultCursorForTool( Tool currentTool );

    void wheelZoom( QWheelEvent * event );
    void updateRubberBandRect( QPointF & pos, const bool constrainSquare = false, const bool fromCenter = false );
    void updateRubberBandLine( const QPointF & pos, const bool constrainAngles = false );
    void removeRubberBand();

    void startMarqueeSelect( QPointF & scenePoint );
    void endMarqueeSelect( QMouseEvent* e );
    void startMarqueeZoom( QPointF & scenePoint );
    void endMarqueeZoom( QMouseEvent* e );

    //void connectAddRemoveCommandSignals( QgsAddRemoveItemCommand* c );

  signals:
    void selectedItemChanged( QgsComposerItem* selected );
    void itemRemoved( QgsComposerItem* );
    void actionFinished();
    void cursorPosChanged( QPointF );
    void zoomLevelChanged();

    void composerViewShow( QgsComposerView* );
    void composerViewHide( QgsComposerView* );

    void compositionSet( QgsComposition* );
};

#endif