qgslayoutviewtool.h

Go to the documentation of this file.

/***************************************************************************
                             qgslayoutviewtool.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 QGSLAYOUTVIEWTOOL_H
#define QGSLAYOUTVIEWTOOL_H

#include "qgis.h"
#include "qgis_gui.h"
#include <QCursor>
#include <QAction>
#include <QPointer>

class QMouseEvent;
class QWheelEvent;
class QKeyEvent;
class QgsLayoutView;
class QgsLayoutViewMouseEvent;
class QgsLayout;
class QgsLayoutItem;

#ifdef SIP_RUN
% ModuleHeaderCode
#include <qgslayoutviewtooladditem.h>
% End
#endif

class GUI_EXPORT QgsLayoutViewTool : public QObject
{

#ifdef SIP_RUN
    SIP_CONVERT_TO_SUBCLASS_CODE
    if ( dynamic_cast<QgsLayoutViewToolAddItem *>( sipCpp ) != NULL )
      sipType = sipType_QgsLayoutViewToolAddItem;
    else
      sipType = NULL;
    SIP_END
#endif

    Q_OBJECT

  public:

    enum Flag
    {
      FlagSnaps = 1 << 1,  
    };
    Q_DECLARE_FLAGS( Flags, Flag )

    ~QgsLayoutViewTool() override;

    QgsLayoutViewTool::Flags flags() const;

    virtual void layoutMoveEvent( QgsLayoutViewMouseEvent *event );

    virtual void layoutDoubleClickEvent( QgsLayoutViewMouseEvent *event );

    virtual void layoutPressEvent( QgsLayoutViewMouseEvent *event );

    virtual void layoutReleaseEvent( QgsLayoutViewMouseEvent *event );

    virtual void wheelEvent( QWheelEvent *event );

    virtual void keyPressEvent( QKeyEvent *event );

    virtual void keyReleaseEvent( QKeyEvent *event );

    void setAction( QAction *action );

    QAction *action();

    void setCursor( const QCursor &cursor );

    virtual void activate();

    virtual void deactivate();

    QString toolName() const { return mToolName; }

    QgsLayoutView *view() const;

    QgsLayout *layout() const;

    virtual QList< QgsLayoutItem * > ignoredSnapItems() const;

  signals:

    void activated();

    void deactivated();

    void itemFocused( QgsLayoutItem *item );

  protected:

    void setFlags( QgsLayoutViewTool::Flags flags );

    QgsLayoutViewTool( QgsLayoutView *view SIP_TRANSFERTHIS, const QString &name );

    bool isClickAndDrag( QPoint startViewPoint, QPoint endViewPoint ) const;

  private:

    QgsLayoutView *mView = nullptr;

    QgsLayoutViewTool::Flags mFlags = nullptr;

    QCursor mCursor = Qt::ArrowCursor;

    QPointer< QAction > mAction;

    QString mToolName;

    friend class TestQgsLayoutView;

};

#endif // QGSLAYOUTVIEWTOOL_H