报表控件NCReport教程：集成NCReport到Qt应用程序中

 NCReport是一款轻量级、快速、多平台、简单易用的基于Qt toolkit的C++编写的报表解决方案，目前主要包括报表渲染库和报表设计器GUI应用程序。

但是好多使用NCReport控件的朋友都不知道如何在Qt应用程序中使用，本文详细的来说明一下。

一、添加NCReport库到应用程序中。

在项目应用程序中使用NCReport，需要先将报表控件集成到应用程序中去，下面有两种方式可以采用：

1、添加所有的静态资源到你的项目中，并用你的应用程序一起构建。在这种情况下，你不需要NCReport分享的库。打开你的.pro项目文件，并像testapp/testapp.pro做的添加全部的源包到项目中。

2、将NCReport作为分享的库使用。要在你的项目中将NCReport库像其他的库一样使用，你需要在你的项目文件中指定它们。

下面的项目示例中展示了一些必要的设置：

QT = xml sql gui core
TEMPLATE = app
CONFIG += warn_on \
qt \
thread \
release
TARGET = MyApplication
INCLUDEPATH = ../ncreport/includes
HEADERS += ...
SOURCES += ...
win32 {
LIBS += ../lib/ncreport2.lib
}
unix {
LIBS += -lncreport -L../lib -L/usr/local/bin
target.path = /usr/local/bin
}

二、初始化NCReport类

本步骤中主要是说明如何初始化NCReport类。 首先需要添加includes.来包含模块类定义，可以使用下面的代码实现：

#include "ncreport.h"
#include "ncreportoutput.h"
#include "ncreportpreviewoutput.h"
#include "ncreportpreviewwindow.h"

创建NCReport类。可以用下面的代码创建一个类似于另一个QObject基础类的报表类：

NCReport report = new NCReport();

如果之前已经创建了NCReport对象，并传递了一个参数，这时初始化报表就需要调用reset()方法：

report->reset();
//or
report->reset( true );

NCReport::reset()函数将会删除所有的对象引用，并使得报表引擎可以再次运行报表。如果参数设置为true，那么报表参数、添加的数据源比如QStringLists、自定义项目都将会被删除。

三、设置报表源

报表源意思就是NCReport处理XML报表定义的方法。报表定义可能从文件打开，但是也可以从一个SQL数据库表导入，下面额示例就是提供了一个作为报表源的文件：

report->setReportFile( fileName );

上面的这段代码相当于下面的代码：

report->setReportSource( NCReportSource::File );
report->reportSource()->setFileName( fileName );

四、添加参数

使用addParameter方法可以添加参数到NCReport中，这个参数的ID是一个字符串，值是一个QVariant对象。

report->addParameter( "id" , QVariant( "value" ) );

上面的这段代码相当于下面的这段代码：

report->addParameter( "paramID" , "Parameter value" );

五、运行报表

现在就可以运行报表为不同的输出。

将报表运行为打印：

report->runReportToPrinter();

将报表运行为PDF：

QString fileName( "mypdffile.pdf" );
report->runReportToPDF( fileName );

将报表运行为打印预览：

report->runReportToPreview();

如果你运行报表为预览，结果将会用一个NCReportPreviewOutput对象保存，报表引擎不会自动运行预览，在报表引擎成功实现之后，我们需要初始化一个NCReportPreviewWindow对象用于预览。但是在做之前需要检查，报表是否发生作为错误。

if ( !report->hasError() ) {
NCReportPreviewWindow pv = new NCReportPreviewWindow();
*
pv->setOutput( (NCReportPreviewOutput )report->output() );
*
pv->setWindowModality( Qt::ApplicationModal );
pv->setAttribute( Qt::WA_DeleteOnClose );
pv->show();
} else {
QMessageBox::warning( tr("Error");
}

使用NCReport::output()函数得到当前的输出：

六、错误处理

可以使用下面的函数来捕捉错误：

bool error = report->hasError();
QString errormsg = report->;lastErrorMsg();

七、删除报表对象

在报表运行操作之后，就可以删除报表对象了，当NCReport删除之后，所有的子对象也都将会被删除：

delete report;

>>>NCReport免费下载