src/core/composer/qgscomposeritem.h

Go to the documentation of this file.

/***************************************************************************
                         qgscomposeritem.h
                             -------------------
    begin                : January 2005
    copyright            : (C) 2005 by Radim Blazek
    email                : blazek@itc.it
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   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 QGSCOMPOSERITEM_H
#define QGSCOMPOSERITEM_H

#include "qgscomposition.h"
#include <QGraphicsRectItem>
#include <QObject>

class QWidget;
class QDomDocument;
class QDomElement;

class QqsComposition;

class CORE_EXPORT QgsComposerItem: public QObject, public QGraphicsRectItem
{
    Q_OBJECT
  public:

    enum ItemType
    {
      // base class for the items
      ComposerItem = UserType + 100,

      // derived classes
      ComposerArrow,
      ComposerItemGroup,
      ComposerLabel,
      ComposerLegend,
      ComposerMap,
      ComposerPaper,  // QgsPaperItem
      ComposerPicture,
      ComposerScaleBar,
      ComposerShape,
      ComposerTable,
      ComposerAttributeTable,
      ComposerTextTable
    };

    enum MouseMoveAction
    {
      MoveItem,
      ResizeUp,
      ResizeDown,
      ResizeLeft,
      ResizeRight,
      ResizeLeftUp,
      ResizeRightUp,
      ResizeLeftDown,
      ResizeRightDown,
      NoAction
    };

    enum ItemPositionMode
    {
      UpperLeft,
      UpperMiddle,
      UpperRight,
      MiddleLeft,
      Middle,
      MiddleRight,
      LowerLeft,
      LowerMiddle,
      LowerRight
    };

    QgsComposerItem( QgsComposition* composition, bool manageZValue = true );
    QgsComposerItem( qreal x, qreal y, qreal width, qreal height, QgsComposition* composition, bool manageZValue = true );
    virtual ~QgsComposerItem();

    virtual int type() const { return ComposerItem; }

    virtual void setSelected( bool s );

    virtual bool selected( void ) {return QGraphicsRectItem::isSelected();}

    virtual bool writeSettings( void );

    virtual bool readSettings( void );

    virtual bool removeSettings( void );

    void move( double dx, double dy );

    virtual void moveContent( double dx, double dy ) { Q_UNUSED( dx ); Q_UNUSED( dy ); }

    virtual void zoomContent( int delta, double x, double y ) { Q_UNUSED( delta ); Q_UNUSED( x ); Q_UNUSED( y ); }

    void setItemPosition( double x, double y, ItemPositionMode itemPoint = UpperLeft );

    void setItemPosition( double x, double y, double width, double height, ItemPositionMode itemPoint = UpperLeft );

    virtual void setSceneRect( const QRectF& rectangle );

    virtual bool writeXML( QDomElement& elem, QDomDocument & doc ) const = 0;

    bool _writeXML( QDomElement& itemElem, QDomDocument& doc ) const;

    virtual bool readXML( const QDomElement& itemElem, const QDomDocument& doc ) = 0;

    bool _readXML( const QDomElement& itemElem, const QDomDocument& doc );



    bool frame() const {return mFrame;}
    void setFrame( bool drawFrame ) {mFrame = drawFrame;}

    virtual void addItem( QgsComposerItem* item ) { Q_UNUSED( item ); }
    virtual void removeItems() {}

    const QgsComposition* composition() const {return mComposition;}

    void beginCommand( const QString& commandText, QgsComposerMergeCommand::Context c = QgsComposerMergeCommand::Unknown );
    void endCommand();
    void cancelCommand();

    //functions that encapsulate the workaround for the Qt font bug (that is to scale the font size up and then scale the
    //painter down by the same factor for drawing

    void drawText( QPainter* p, double x, double y, const QString& text, const QFont& font ) const;

    void drawText( QPainter* p, const QRectF& rect, const QString& text, const QFont& font, Qt::AlignmentFlag halignement = Qt::AlignLeft, Qt::AlignmentFlag valignement = Qt::AlignTop ) const;

    double textWidthMillimeters( const QFont& font, const QString& text ) const;

    double fontHeightCharacterMM( const QFont& font, const QChar& c ) const;

    double fontAscentMillimeters( const QFont& font ) const;

    double pixelFontSize( double pointSize ) const;

    QFont scaledFontPixelSize( const QFont& font ) const;

    void setPositionLock( bool lock ) {mItemPositionLocked = lock;}

    bool positionLock() const {return mItemPositionLocked;}

    void updateCursor( const QPointF& itemPos );

    double rotation() const {return mRotation;}

  public slots:
    virtual void setRotation( double r );
    void repaint();

  protected:

    QgsComposition* mComposition;

    QgsComposerItem::MouseMoveAction mCurrentMouseMoveAction;
    QPointF mMouseMoveStartPos;
    QPointF mLastMouseEventPos;

    QGraphicsRectItem* mBoundingResizeRectangle;

    bool mFrame;

    bool mItemPositionLocked;

    mutable double mLastValidViewScaleFactor;

    double mRotation;

    //event handlers
    virtual void mouseMoveEvent( QGraphicsSceneMouseEvent * event );
    virtual void mousePressEvent( QGraphicsSceneMouseEvent * event );
    virtual void mouseReleaseEvent( QGraphicsSceneMouseEvent * event );

    virtual void hoverMoveEvent( QGraphicsSceneHoverEvent * event );

    Qt::CursorShape cursorForPosition( const QPointF& itemCoordPos );

    QgsComposerItem::MouseMoveAction mouseMoveActionForPosition( const QPointF& itemCoordPos );

    void changeItemRectangle( const QPointF& currentPosition, const QPointF& mouseMoveStartPos, const QGraphicsRectItem* originalItem, double dx, double dy, QGraphicsRectItem* changeItem );

    virtual void drawSelectionBoxes( QPainter* p );

    virtual void drawFrame( QPainter* p );

    virtual void drawBackground( QPainter* p );

    void drawArrowHead( QPainter* p, double x, double y, double angle, double arrowHeadWidth ) const;

    double angle( const QPointF& p1, const QPointF& p2 ) const;

    double rectHandlerBorderTolerance() const;

    double lockSymbolSize() const;

    double horizontalViewScaleFactor() const;

    //some utility functions

    bool imageSizeConsideringRotation( double& width, double& height ) const;
    bool cornerPointOnRotatedAndScaledRect( double& x, double& y, double width, double height ) const;
    QPointF pointOnLineWithDistance( const QPointF& startPoint, const QPointF& directionPoint, double distance ) const;
    void sizeChangedByRotation( double& width, double& height );
    void rotate( double angle, double& x, double& y ) const;

  signals:
    void rotationChanged( double newRotation );
    void itemChanged();
};

#endif