qgscomposerhtml.h

Go to the documentation of this file.

/***************************************************************************
                              qgscomposerhtml.h
    ------------------------------------------------------------
    begin                : July 2012
    copyright            : (C) 2012 by Marco Hugentobler
    email                : marco dot hugentobler at sourcepole dot ch
 ***************************************************************************
 *                                                                         *
 *   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 QGSCOMPOSERHTML_H
#define QGSCOMPOSERHTML_H

#include "qgscomposermultiframe.h"
#include <QUrl>

class QWebPage;
class QImage;
class QgsFeature;
class QgsVectorLayer;
class QgsNetworkContentFetcher;
class QgsDistanceArea;

class CORE_EXPORT QgsComposerHtml: public QgsComposerMultiFrame
{
    Q_OBJECT
  public:

    enum ContentMode
    {
      Url, /*< Using this mode item fetches its content via a url*/
      ManualHtml /*< HTML content is manually set for the item*/
    };

    QgsComposerHtml( QgsComposition* c, bool createUndoCommands );

    //should be private - fix for QGIS 3.0
    QgsComposerHtml();

    ~QgsComposerHtml();

    void setContentMode( ContentMode mode ) { mContentMode = mode; }

    ContentMode contentMode() const { return mContentMode; }

    void setUrl( const QUrl& url );

    const QUrl& url() const { return mUrl; }

    void setHtml( const QString html );

    QString html() const { return mHtml; }

    bool evaluateExpressions() const { return mEvaluateExpressions; }

    void setEvaluateExpressions( bool evaluateExpressions );

    bool useSmartBreaks() const { return mUseSmartBreaks; }

    void setUseSmartBreaks( bool useSmartBreaks );

    void setMaxBreakDistance( double maxBreakDistance );

    double maxBreakDistance() const { return mMaxBreakDistance; }

    void setUserStylesheet( const QString stylesheet );

    QString userStylesheet() const { return mUserStylesheet; }

    void setUserStylesheetEnabled( const bool stylesheetEnabled );

    bool userStylesheetEnabled() const { return mEnableUserStylesheet; }

    virtual QString displayName() const;
    QSizeF totalSize() const;
    void render( QPainter* p, const QRectF& renderExtent, const int frameIndex );
    bool writeXML( QDomElement& elem, QDomDocument & doc, bool ignoreFrames = false ) const;
    bool readXML( const QDomElement& itemElem, const QDomDocument& doc, bool ignoreFrames = false );
    void addFrame( QgsComposerFrame* frame, bool recalcFrameSizes = true );
    //overriden to break frames without dividing lines of text
    double findNearbyPageBreak( double yPos );

  public slots:

    void loadHtml();

    void recalculateFrameSizes();
    void refreshExpressionContext();

    virtual void refreshDataDefinedProperty( const QgsComposerObject::DataDefinedProperty property = QgsComposerObject::AllProperties );

  private slots:
    void frameLoaded( bool ok = true );

  private:
    ContentMode mContentMode;
    QUrl mUrl;
    QWebPage* mWebPage;
    QString mHtml;
    QString mFetchedHtml;
    QString mLastFetchedUrl;
    QString mActualFetchedUrl; //may be different if page was redirected
    bool mLoaded;
    QSizeF mSize; //total size in mm
    double mHtmlUnitsToMM;
    QImage* mRenderedPage;
    bool mEvaluateExpressions;
    bool mUseSmartBreaks;
    double mMaxBreakDistance;

    QgsFeature* mExpressionFeature;
    QgsVectorLayer* mExpressionLayer;
    QgsDistanceArea* mDistanceArea;

    QString mUserStylesheet;
    bool mEnableUserStylesheet;

    QgsNetworkContentFetcher* mFetcher;

    double htmlUnitsToMM(); //calculate scale factor

    //renders a snapshot of the page to a cached image
    void renderCachedImage();

    //fetches html content from a url and returns it as a string
    QString fetchHtml( QUrl url );

    void setExpressionContext( QgsFeature* feature, QgsVectorLayer* layer );

    double maxFrameWidth() const;
};

#endif // QGSCOMPOSERHTML_H