qgslayoutpagecollection.h

Go to the documentation of this file.

/***************************************************************************
                              qgslayoutpagecollection.h
                             --------------------------
    begin                : July 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 QGSLAYOUTPAGECOLLECTION_H
#define QGSLAYOUTPAGECOLLECTION_H
 
#include <memory>
 
#include "qgis_core.h"
#include "qgis_sip.h"
#include "qgslayout.h"
#include "qgslayoutitem.h"
#include "qgslayoutitempage.h"
#include "qgslayoutpoint.h"
#include "qgslayoutserializableobject.h"
 
#include <QObject>
 
class QgsLayout;
class QgsLayoutGuideCollection;
class QgsMargins;

class CORE_EXPORT QgsLayoutPageCollection : public QObject, public QgsLayoutSerializableObject
{
 
    Q_OBJECT
 
  public:

    explicit QgsLayoutPageCollection( QgsLayout *layout SIP_TRANSFERTHIS );
 
    ~QgsLayoutPageCollection() override;
 
    QString stringType() const override { return QStringLiteral( "LayoutPageCollection" ); }
    QgsLayout *layout() override;

    QList< QgsLayoutItemPage * > pages();

    int pageCount() const;

    QgsLayoutItemPage *page( int pageNumber );

    const QgsLayoutItemPage *page( int pageNumber ) const SIP_SKIP;

    int pageNumber( QgsLayoutItemPage *page ) const;

    QList< QgsLayoutItemPage * > visiblePages( const QRectF &region ) const;

    QList< int > visiblePageNumbers( const QRectF &region ) const;

    bool pageIsEmpty( int page ) const;

    QList< QgsLayoutItem *> itemsOnPage( int page ) const;

    template<class T> void itemsOnPage( QList<T *> &itemList, int page ) const SIP_SKIP
    {
      itemList.clear();
      const QList<QGraphicsItem *> graphicsItemList = mLayout->items();
      for ( QGraphicsItem *graphicsItem : graphicsItemList )
      {
        T *item = dynamic_cast<T *>( graphicsItem );
        if ( item && item->page() == page )
        {
          itemList.push_back( item );
        }
      }
    }

    bool shouldExportPage( int page ) const;

    void addPage( QgsLayoutItemPage *page SIP_TRANSFER );

    QgsLayoutItemPage *extendByNewPage();

    void insertPage( QgsLayoutItemPage *page SIP_TRANSFER, int beforePage );

    void deletePage( int pageNumber );

    void deletePage( QgsLayoutItemPage *page );

    void clear();

    QgsLayoutItemPage *takePage( QgsLayoutItemPage *page ) SIP_TRANSFERBACK;

    void setPageStyleSymbol( QgsFillSymbol *symbol );

    Q_DECL_DEPRECATED const QgsFillSymbol *pageStyleSymbol() const SIP_DEPRECATED;

    void beginPageSizeChange();

    void endPageSizeChange();

    void reflow();

    double maximumPageWidth() const;

    QSizeF maximumPageSize() const;

    bool hasUniformPageSizes() const;

    int pageNumberForPoint( QPointF point ) const;

    int predictPageNumberForPoint( QPointF point ) const;

    QgsLayoutItemPage *pageAtPoint( QPointF point ) const;

    QPointF pagePositionToLayoutPosition( int page, const QgsLayoutPoint &position ) const;

    QgsLayoutPoint pagePositionToAbsolute( int page, const QgsLayoutPoint &position ) const;

    QPointF positionOnPage( QPointF point ) const;

    double spaceBetweenPages() const;

    double pageShadowWidth() const;

    void resizeToContents( const QgsMargins &margins, Qgis::LayoutUnit marginUnits );

    bool writeXml( QDomElement &parentElement, QDomDocument &document, const QgsReadWriteContext &context ) const override;

    bool readXml( const QDomElement &collectionElement, const QDomDocument &document, const QgsReadWriteContext &context ) override;

    QgsLayoutGuideCollection &guides();

    SIP_SKIP const QgsLayoutGuideCollection &guides() const;

    void applyPropertiesToAllOtherPages( int sourcePage );
 
  public slots:

    void redraw();
 
  signals:

    void changed();

    void pageAboutToBeRemoved( int pageNumber );
 
  private:
 
    QgsLayout *mLayout = nullptr;
 
    std::unique_ptr< QgsLayoutGuideCollection > mGuideCollection;

    std::unique_ptr< QgsFillSymbol > mPageStyleSymbol;
 
    QList< QgsLayoutItemPage * > mPages;
 
    bool mBlockUndoCommands = false;
 
    QMap< QString, QPair< int, QgsLayoutPoint > > mPreviousItemPositions;
 
    void createDefaultPageStyleSymbol();
 
    friend class QgsLayoutPageCollectionUndoCommand;
};
 
#endif //QGSLAYOUTPAGECOLLECTION_H