qgslayoutview.h

Go to the documentation of this file.

/***************************************************************************
                             qgslayoutview.h
                             ---------------
    Date                 : July 2017
    Copyright            : (C) 2017 Nyall Dawson
    Email                : nyall dot dawson at gmail dot com
 ***************************************************************************/
 
/***************************************************************************
 *                                                                         *
 *   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 QGSLAYOUTVIEW_H
#define QGSLAYOUTVIEW_H
 
#include <memory>
 
#include "qgis_gui.h"
#include "qgis_sip.h"
#include "qgslayoutaligner.h"
#include "qgslayoutitempage.h"
#include "qgslayoutviewtool.h"
#include "qgsprevieweffect.h"
 
#include <QGraphicsRectItem>
#include <QGraphicsView>
#include <QPointer>
 
class QMenu;
class QgsLayout;
class QgsLayoutViewToolTemporaryKeyPan;
class QgsLayoutViewToolTemporaryKeyZoom;
class QgsLayoutViewToolTemporaryMousePan;
class QgsLayoutRuler;
class QgsLayoutViewMenuProvider;
class QgsLayoutViewSnapMarker;
class QgsLayoutReportSectionLabel;
class QgsScreenHelper;

class GUI_EXPORT QgsLayoutView : public QGraphicsView
{
#ifdef SIP_RUN
    SIP_CONVERT_TO_SUBCLASS_CODE
    if ( qobject_cast<QgsLayoutView *>( sipCpp ) )
      sipType = sipType_QgsLayoutView;
    else
      sipType = NULL;
    SIP_END
#endif
 
    Q_OBJECT
 
    Q_PROPERTY( QgsLayout *currentLayout READ currentLayout WRITE setCurrentLayout NOTIFY layoutSet )
    Q_PROPERTY( QgsLayoutViewTool *tool READ tool WRITE setTool NOTIFY toolSet )
 
  public:
    enum ClipboardOperation
    {
      ClipboardCut,  
      ClipboardCopy, 
    };

    enum PasteMode
    {
      PasteModeCursor,  
      PasteModeCenter,  
      PasteModeInPlace, 
    };

    QgsLayoutView( QWidget *parent SIP_TRANSFERTHIS = nullptr );
 
    ~QgsLayoutView() override;

    QgsLayout *currentLayout();

    SIP_SKIP const QgsLayout *currentLayout() const;

    void setCurrentLayout( QgsLayout *layout SIP_KEEPREFERENCE );

    QgsLayoutViewTool *tool();

    void setTool( QgsLayoutViewTool *tool );

    void unsetTool( QgsLayoutViewTool *tool );

    void setPreviewModeEnabled( bool enabled );

    bool previewModeEnabled() const;

    void setPreviewMode( QgsPreviewEffect::PreviewMode mode );

    QgsPreviewEffect::PreviewMode previewMode() const;

    void scaleSafe( double scale );

    void setZoomLevel( double level );

    void setHorizontalRuler( QgsLayoutRuler *ruler );

    void setVerticalRuler( QgsLayoutRuler *ruler );

    void setMenuProvider( QgsLayoutViewMenuProvider *provider SIP_TRANSFER );

    QgsLayoutViewMenuProvider *menuProvider() const;

    int currentPage() const { return mCurrentPage; }

    QList<QgsLayoutItemPage *> visiblePages() const;

    QList<int> visiblePageNumbers() const;

    void alignSelectedItems( QgsLayoutAligner::Alignment alignment );

    void distributeSelectedItems( QgsLayoutAligner::Distribution distribution );

    void resizeSelectedItems( QgsLayoutAligner::Resize resize );

    void copySelectedItems( ClipboardOperation operation );

    void copyItems( const QList<QgsLayoutItem *> &items, ClipboardOperation operation );

    QList<QgsLayoutItem *> pasteItems( PasteMode mode );

    QList<QgsLayoutItem *> pasteItems( QPointF layoutPoint );

    bool hasItemsInClipboard() const;

    QPointF deltaForKeyEvent( QKeyEvent *event );

    void setPaintingEnabled( bool enabled ) SIP_SKIP;

    void setSectionLabel( const QString &label );
 
  public slots:

    void zoomFull();

    void zoomWidth();

    void zoomIn();

    void zoomOut();

    void zoomActual();

    // NOTE - I realize these emitXXX methods are gross, but there's no clean
    // alternative here. We can't override the non-virtual Qt QGraphicsView
    // methods, and adding our own renamed methods which call the base class
    // methods also adds noise to the API.
    void emitZoomLevelChanged();
 
    // Why are these select methods in the view and not in the scene (QgsLayout)?
    // Well, in my opinion selections are purely a GUI concept. Ideally
    // NONE of the selection handling would be done in core, but we're restrained
    // by the QGraphicsScene API here.

    void selectAll();

    void deselectAll();

    void invertSelection();

    void selectNextItemAbove();

    void selectNextItemBelow();

    void raiseSelectedItems();

    void lowerSelectedItems();

    void moveSelectedItemsToTop();

    void moveSelectedItemsToBottom();

    void lockSelectedItems();

    void unlockAllItems();

    void deleteSelectedItems();

    void deleteItems( const QList<QgsLayoutItem *> &items );

    void groupSelectedItems();

    void ungroupSelectedItems();

    void viewChanged();

    void pushStatusMessage( const QString &message );
 
  signals:

    void layoutSet( QgsLayout *layout );

    void toolSet( QgsLayoutViewTool *tool );

    void zoomLevelChanged();

    void cursorPosChanged( QPointF layoutPoint );

    void pageChanged( int page );

    void statusMessage( const QString &message );

    void itemFocused( QgsLayoutItem *item );

    void willBeDeleted();
 
  protected:
    void mousePressEvent( QMouseEvent *event ) override;
    void mouseReleaseEvent( QMouseEvent *event ) override;
    void mouseMoveEvent( QMouseEvent *event ) override;
    void mouseDoubleClickEvent( QMouseEvent *event ) override;
    void wheelEvent( QWheelEvent *event ) override;
    void keyPressEvent( QKeyEvent *event ) override;
    void keyReleaseEvent( QKeyEvent *event ) override;
    void resizeEvent( QResizeEvent *event ) override;
    void scrollContentsBy( int dx, int dy ) override;
    void dragEnterEvent( QDragEnterEvent *e ) override;
    void paintEvent( QPaintEvent *event ) override;
 
  private slots:
 
    void invalidateCachedRenders();
 
  private:
    void wheelZoom( QWheelEvent *event );
 
    QgsScreenHelper *mScreenHelper = nullptr;
 
    QPointer<QgsLayoutViewTool> mTool;
 
    QgsLayoutViewToolTemporaryKeyPan *mSpacePanTool = nullptr;
    QgsLayoutViewToolTemporaryMousePan *mMidMouseButtonPanTool = nullptr;
    QgsLayoutViewToolTemporaryKeyZoom *mSpaceZoomTool = nullptr;
 
    QPoint mMouseCurrentXY;
 
    QgsLayoutRuler *mHorizontalRuler = nullptr;
    QgsLayoutRuler *mVerticalRuler = nullptr;
    std::unique_ptr<QgsLayoutViewMenuProvider> mMenuProvider;
 
    QgsLayoutViewSnapMarker *mSnapMarker = nullptr;
    QgsLayoutReportSectionLabel *mSectionLabel = nullptr;
 
    QGraphicsLineItem *mHorizontalSnapLine = nullptr;
    QGraphicsLineItem *mVerticalSnapLine = nullptr;
 
    int mCurrentPage = 0;
 
    QgsPreviewEffect *mPreviewEffect = nullptr;
 
    bool mPaintingEnabled = true;
 
    friend class TestQgsLayoutView;
    friend class QgsLayoutMouseHandles;
 
    QGraphicsLineItem *createSnapLine() const;
};
 

class GUI_EXPORT QgsLayoutViewMenuProvider
{
  public:
    virtual ~QgsLayoutViewMenuProvider() = default;

    virtual QMenu *createContextMenu( QWidget *parent SIP_TRANSFER, QgsLayout *layout, QPointF layoutPoint ) const = 0 SIP_FACTORY;
};
 
 
#ifndef SIP_RUN
 

class GUI_EXPORT QgsLayoutViewSnapMarker : public QGraphicsRectItem
{
  public:
    QgsLayoutViewSnapMarker();
 
    void paint( QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr ) override;
 
  private:
    int mSize = 0;
};

#endif
 
#endif // QGSLAYOUTVIEW_H