KDReportsReport.h

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

    void setDefaultFont( const QFont& font );

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

#if QT_VERSION >= 0x040400
    void setTabPositions( const QList<QTextOption::Tab>& tabs );
#endif

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

#if QT_VERSION >= 0x040400

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

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

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

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

    void setXmlElementHandler( KDReports::XmlElementHandler* handler );

    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 */