qgstextformat.h

Go to the documentation of this file.

/***************************************************************************
  qgstextformat.h
  ---------------
   begin                : May 2020
   copyright            : (C) 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 QGSTEXTFORMAT_H
#define QGSTEXTFORMAT_H
 
#include "qgis_sip.h"
#include "qgis_core.h"
#include "qgsunittypes.h"
#include "qgstextbuffersettings.h"
#include "qgstextbackgroundsettings.h"
#include "qgstextshadowsettings.h"
#include "qgstextmasksettings.h"
#include "qgsstringutils.h"
 
#include <QSharedDataPointer>
 
class QMimeData;
class QgsTextSettingsPrivate;
 
class CORE_EXPORT QgsTextFormat
{
  public:
 
    enum TextOrientation
    {
      HorizontalOrientation, 
      VerticalOrientation, 
      RotationBasedOrientation, 
    };
 
    QgsTextFormat();
 
    QgsTextFormat( const QgsTextFormat &other );
 
    QgsTextFormat &operator=( const QgsTextFormat &other );
 
    ~QgsTextFormat();
 
    bool operator==( const QgsTextFormat &other ) const;
    bool operator!=( const QgsTextFormat &other ) const;
 
    bool isValid() const;
 
    void setValid();
 
    QgsTextBufferSettings &buffer();
 
    SIP_SKIP QgsTextBufferSettings buffer() const { return mBufferSettings; }
 
    void setBuffer( const QgsTextBufferSettings &bufferSettings );
 
    QgsTextBackgroundSettings &background();
 
    SIP_SKIP QgsTextBackgroundSettings background() const { return mBackgroundSettings; }
 
    void setBackground( const QgsTextBackgroundSettings &backgroundSettings );
 
    QgsTextShadowSettings &shadow();
 
    SIP_SKIP QgsTextShadowSettings shadow() const { return mShadowSettings; }
 
    void setShadow( const QgsTextShadowSettings &shadowSettings );
 
    QgsTextMaskSettings &mask();
 
    SIP_SKIP QgsTextMaskSettings mask() const { return mMaskSettings; }
 
    void setMask( const QgsTextMaskSettings &maskSettings );
 
    QFont font() const;
 
    QFont scaledFont( const QgsRenderContext &context, double scaleFactor = 1.0, bool *isZeroSize SIP_PYARGREMOVE = nullptr ) const;
 
    void setFont( const QFont &font );
 
    QString namedStyle() const;
 
    void setNamedStyle( const QString &style );
 
    QStringList families() const;
 
    void setFamilies( const QStringList &families );
 
    double size() const;
 
    void setSize( double size );
 
    QgsUnitTypes::RenderUnit sizeUnit() const;
 
    void setSizeUnit( QgsUnitTypes::RenderUnit unit );
 
    QgsMapUnitScale sizeMapUnitScale() const;
 
    void setSizeMapUnitScale( const QgsMapUnitScale &scale );
 
    QColor color() const;
 
    void setColor( const QColor &color );
 
    double opacity() const;
 
    void setOpacity( double opacity );
 
    QPainter::CompositionMode blendMode() const;
 
    void setBlendMode( QPainter::CompositionMode mode );
 
    double lineHeight() const;
 
    void setLineHeight( double height );
 
    TextOrientation orientation() const;
 
    void setOrientation( TextOrientation orientation );
 
    QgsStringUtils::Capitalization capitalization() const;
 
    void setCapitalization( QgsStringUtils::Capitalization capitalization );
 
    bool allowHtmlFormatting() const;
 
    void setAllowHtmlFormatting( bool allow );
 
    QColor previewBackgroundColor() const;
 
    void setPreviewBackgroundColor( const QColor &color );
 
    void readFromLayer( QgsVectorLayer *layer );
 
    void readXml( const QDomElement &elem, const QgsReadWriteContext &context );
 
    QDomElement writeXml( QDomDocument &doc, const QgsReadWriteContext &context ) const;
 
    QMimeData *toMimeData() const SIP_FACTORY;
 
    static QgsTextFormat fromQFont( const QFont &font );
 
    QFont toQFont() const;
 
    static QgsTextFormat fromMimeData( const QMimeData *data, bool *ok SIP_OUT = nullptr );
 
    bool containsAdvancedEffects() const;
 
    bool fontFound() const { return mTextFontFound; }
 
    QString resolvedFontFamily() const { return mTextFontFamily; }
 
    QgsPropertyCollection &dataDefinedProperties();
 
    const QgsPropertyCollection &dataDefinedProperties() const SIP_SKIP;
 
    QSet<QString> referencedFields( const QgsRenderContext &context ) const;
 
    void setDataDefinedProperties( const QgsPropertyCollection &collection );
 
    void updateDataDefinedProperties( QgsRenderContext &context );
 
    static QPixmap textFormatPreviewPixmap( const QgsTextFormat &format, QSize size, const QString &previewText = QString(), int padding = 0 );
 
  private:
 
    QgsTextBufferSettings mBufferSettings;
    QgsTextBackgroundSettings mBackgroundSettings;
    QgsTextShadowSettings mShadowSettings;
    QgsTextMaskSettings mMaskSettings;
 
    QString mTextFontFamily;
    bool mTextFontFound = true;
 
    QSharedDataPointer<QgsTextSettingsPrivate> d;
 
};
 
Q_DECLARE_METATYPE( QgsTextFormat )
 
#endif // QGSTEXTFORMAT_H