qgslayoutitemlabel.h

Go to the documentation of this file.

/***************************************************************************
                             qgslayoutitemlabel.h
                             -------------------
    begin                : October 2017
    copyright            : (C) 2017 by 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 QGSLAYOUTITEMLABEL_H
#define QGSLAYOUTITEMLABEL_H

#include "qgis_core.h"
#include "qgslayoutitem.h"
#include "qgswebpage.h"
#include <QFont>

class QgsVectorLayer;
class QgsFeature;
class QgsDistanceArea;

class CORE_EXPORT QgsLayoutItemLabel: public QgsLayoutItem
{
    Q_OBJECT

  public:

    enum Mode
    {
      ModeFont, 
      ModeHtml, 
    };

    QgsLayoutItemLabel( QgsLayout *layout );

    static QgsLayoutItemLabel *create( QgsLayout *layout ) SIP_FACTORY;

    int type() const override;
    QIcon icon() const override;
    //Overridden to contain part of label's text
    QString displayName() const override;

    void adjustSizeToText();

    QSizeF sizeForText() const;

    QString text() const { return mText; }

    void setText( const QString &text );

    QString currentText() const;

    Mode mode() const { return mMode; }

    void setMode( Mode mode );

    QFont font() const;

    void setFont( const QFont &font );

    Qt::AlignmentFlag vAlign() const { return mVAlignment; }

    Qt::AlignmentFlag hAlign() const { return mHAlignment; }

    void setHAlign( Qt::AlignmentFlag alignment ) { mHAlignment = alignment; }

    void setVAlign( Qt::AlignmentFlag alignment ) { mVAlignment = alignment; }

    double marginX() const { return mMarginX; }

    double marginY() const { return mMarginY; }

    void setMargin( double margin );

    void setMarginX( double margin );

    void setMarginY( double margin );

    void setFontColor( const QColor &color ) { mFontColor = color; }

    QColor fontColor() const { return mFontColor; }

    // In case of negative margins, the bounding rect may be larger than the
    // label's frame
    QRectF boundingRect() const override;

    // Reimplemented to call prepareGeometryChange after toggling frame
    void setFrameEnabled( bool drawFrame ) override;

    // Reimplemented to call prepareGeometryChange after changing stroke width
    void setFrameStrokeWidth( QgsLayoutMeasurement strokeWidth ) override;

  public slots:

    void refresh() override;

  protected:
    void draw( QgsLayoutItemRenderContext &context ) override;
    bool writePropertiesToElement( QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context ) const override;
    bool readPropertiesFromElement( const QDomElement &element, const QDomDocument &document, const QgsReadWriteContext &context ) override;

  private slots:

    void loadingHtmlFinished( bool );

    void refreshExpressionContext();

  private:
    bool mFirstRender = true;

    // Text
    QString mText;

    Mode mMode = ModeFont;
    double mHtmlUnitsToLayoutUnits = 1.0;
    double htmlUnitsToLayoutUnits(); //calculate scale factor
    bool mHtmlLoaded = false;

    void itemShiftAdjustSize( double newWidth, double newHeight, double &xShift, double &yShift ) const;

    void contentChanged();

    QFont mFont;

    double mMarginX = 0.0;
    double mMarginY = 0.0;

    QColor mFontColor = QColor( 0, 0, 0 );

    Qt::AlignmentFlag mHAlignment = Qt::AlignJustify;

    Qt::AlignmentFlag mVAlignment = Qt::AlignTop;

    void replaceDateText( QString &text ) const;

    QUrl createStylesheetUrl() const;

    std::unique_ptr< QgsDistanceArea > mDistanceArea;

    std::unique_ptr< QgsWebPage > mWebPage;
};

#endif //QGSLAYOUTITEMLABEL_H