KDReportsReport.h

/****************************************************************************
** Copyright (C) 2007-2011 Klaralvdalens Datakonsult AB.  All rights reserved.
**
** This file is part of the KD Reports library.
**
** Licensees holding valid commercial KD Reports licenses may use this file in
** accordance with the KD Reports Commercial License Agreement provided with
** the Software.
**
**
** This file may be distributed and/or modified under the terms of the
** GNU General Public License version 2 and version 3 as published by the
** Free Software Foundation and appearing in the file LICENSE.GPL included.
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
** Contact info@kdab.com if any conditions of this licensing are not
** clear to you.
**
**********************************************************************/

#ifndef KDREPORTSREPORT_H
#define KDREPORTSREPORT_H

#include "KDReportsErrorDetails.h"
#include "KDReportsGlobal.h"
#include <QtCore/QSizeF>
#include <QtGui/QPrinter>
#include <QtGui/QColor>
#include <QtGui/QFont>
#include <QtGui/QTextOption>

class QDomDocument;
class QTextDocumentFragment;
class QTextDocument;
class QDomElement;
class QDomNode;
class QAbstractItemModel;
class QIODevice;
class QRect;
class QPainter;
namespace KDReports {

class MainTable;
class XmlParser;
class Element;
class HeaderReportBuilder;
class Header;
typedef Header Footer;
class ReportPrivate;
class ReportBuilder;
class PreviewDialog;
class TextDocument;
class TableBreakingSettingsDialog;
class AutoTableElement;
class XmlElementHandler;

enum HeaderLocation {
    FirstPage = 1, 
    EvenPages = 2, 
    OddPages = 4,  
    LastPage = 8,  
    AllPages = OddPages | EvenPages 
};
Q_DECLARE_FLAGS( HeaderLocations, HeaderLocation )


class KDREPORTS_EXPORT Report : public QObject
{
    Q_OBJECT

public:
    Report( QObject* parent = 0 );
    ~Report();

    enum ReportMode {
        WordProcessing = 0,
        SpreadSheet = 1
    };

    void setReportMode( ReportMode reportMode );

    ReportMode reportMode() const;

    void setDefaultFont( const QFont& font );

    MainTable* mainTable() const;

    void addInlineElement( const Element& element );

    void addElement( const Element& element, Qt::AlignmentFlag horizontalAlignment = Qt::AlignLeft,
                     const QColor& backgroundColor = QColor() );

    void addVerticalSpacing( qreal space );

    void addFragment( const QTextDocumentFragment& fragment );

    void addPageBreak();

    void setTabPositions( const QList<QTextOption::Tab>& tabs );

    QTextOption::Tab rightAlignedTab() const;

    QTextOption::Tab middleAlignedTab() const;

    void setParagraphMargins( qreal left, qreal top, qreal right, qreal bottom );

    void setPageSize( const QPrinter::PageSize& size );

    void setPaperSize( const QSizeF & paperSize, QPrinter::Unit unit );

    QPrinter::PageSize pageSize() const;
    void setOrientation( QPrinter::Orientation orientation );
    QPrinter::Orientation orientation() const;

    void setWidthForEndlessPrinter( qreal widthMM );

    void setMargins( qreal top, qreal left, qreal bottom, qreal right );

    void getMargins( qreal* top, qreal* left, qreal* bottom, qreal* right ) const;

    void setHeaderBodySpacing( qreal spacing );

    void setFooterBodySpacing( qreal spacing );

    Header& header( HeaderLocations hl = AllPages );

    Footer& footer( HeaderLocations hl = AllPages );

    void associateModel( const QString& modelKey, QAbstractItemModel* model );

    void associateTextValue( const QString& id, const QString& value );

    void associateImageValue( const QString& id, const QPixmap& value );

    void associateImageValue( const QString& id, const QImage& value );

    bool loadFromXML( QIODevice* iodevice, ErrorDetails* details = 0 );

    bool loadFromXML( const QDomDocument& doc, ErrorDetails* details = 0 );

    void setXmlElementHandler( KDReports::XmlElementHandler* handler );

    void setCurrentRow( const QAbstractItemModel *model, int row );

    bool printWithDialog( QWidget* parent );

    bool print( QPrinter* printer, QWidget* parent = 0 );

    bool exportToFile( const QString& fileName, QWidget* parent = 0 );

    bool exportToImage( const QSize& size, const QString& fileName, const char* format );

    bool exportToHtml( const QString& fileName );

    void paintPage( int pageNumber, QPainter& painter );

    int numberOfPages() const;

    void setTableBreakingEnabled( bool tableBreakingEnabled );

    bool isTableBreakingEnabled() const;

    enum TableBreakingPageOrder { DownThenRight, RightThenDown };

    void setTableBreakingPageOrder( TableBreakingPageOrder pageOrder );

    TableBreakingPageOrder tableBreakingPageOrder() const;

    void setFontScalingFactor( qreal factor );

    qreal fontScalingFactor() const;

    void scaleTo( int numPagesHorizontally, int numPagesVertically );

    int maximumNumberOfPagesForHorizontalScaling() const;
    int maximumNumberOfPagesForVerticalScaling() const;

    QList<KDReports::AutoTableElement *> autoTableElements() const;

    void regenerateAutoTables();

    void regenerateAutoTableForModel( QAbstractItemModel* model );

    void setWatermarkText( const QString& text,
                           int rotation = 0,
                           const QColor& color = QColor( 204, 204, 204 ),
                           const QFont& font = QFont( QLatin1String( "Helvetica" ), 48 ) );

    QString watermarkText() const;

    int watermarkRotation() const;

    QColor watermarkColor() const;

    QFont watermarkFont() const;

    void setWatermarkPixmap( const QPixmap& pixmap, bool autoGrayOut = true );

    QPixmap watermarkPixmap() const;

    void setWatermarkImage( const QImage& image );

    QImage watermarkImage() const;

    QSizeF paperSize() const;

    void dump() const;

private:
    friend class Test;
    KDReports::TextDocument& doc() const;

    QString asHtml() const;

private:
    Q_DISABLE_COPY( Report )
    friend class HeaderReportBuilder; // for headerChanged()
    friend class ImageElement; // for textDocumentWidth()
    friend class ChartElement; // for textDocumentWidth()
    friend class XmlParser; // d->m_builder
    friend class Header; // doc()
    ReportPrivate* const d;
};

}

#endif /* KDREPORTSREPORT_H */