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 "qgstextformat.h"
 
#include <QFont>
#include <QUrl>
 
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();

    void adjustSizeToText( QgsLayoutItem::ReferencePoint referencePoint );

    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 );

    Q_DECL_DEPRECATED QFont font() const SIP_DEPRECATED;

    Q_DECL_DEPRECATED void setFont( const QFont &font ) SIP_DEPRECATED;

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

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

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

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

    double marginX() const { return mMarginX; }

    double marginY() const { return mMarginY; }

    void setMargin( double margin );

    void setMarginX( double margin );

    void setMarginY( double margin );

    Q_DECL_DEPRECATED void setFontColor( const QColor &color ) SIP_DEPRECATED { mFormat.setColor( color ); }

    Q_DECL_DEPRECATED QColor fontColor() const SIP_DEPRECATED { return mFormat.color(); }
 
    // In case of negative margins, the bounding rect may be larger than the
    // label's frame
    QRectF boundingRect() const override;
    void setFrameEnabled( bool drawFrame ) override;
    void setFrameStrokeWidth( QgsLayoutMeasurement strokeWidth ) override;

    QgsTextFormat textFormat() const;

    void setTextFormat( const QgsTextFormat &format );
 
  public slots:
 
    void refresh() override;

    void convertToStaticText();
 
  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 refreshExpressionContext();
    void updateBoundingRect();
 
  private:
    // Text
    QString mText;
 
    Mode mMode = ModeFont;
    double mHtmlUnitsToLayoutUnits = 1.0;
    double htmlUnitsToLayoutUnits(); //calculate scale factor

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

    void contentChanged();
 
    QgsTextFormat mFormat;

    double mMarginX = 0.0;
    double mMarginY = 0.0;

    Qt::AlignmentFlag mHAlignment = Qt::AlignLeft;

    Qt::AlignmentFlag mVAlignment = Qt::AlignTop;

    void replaceDateText( QString &text ) const;

    QFont createDefaultFont() const;

    QUrl createStylesheetUrl() const;

    QString createStylesheet() const;
 
    std::unique_ptr< QgsDistanceArea > mDistanceArea;
 
    QRectF mCurrentRectangle;
 
    friend class QgsLayoutItemHtml;
};
 
#endif //QGSLAYOUTITEMLABEL_H