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

原创|使用教程|编辑:龚雪|2013-12-05 15:02:27.000|阅读 3206 次

概述:NCReport是一款轻量级、快速、多平台、简单易用的基于Qt toolkit的C++编写的报表解决方案,目前主要包括报表渲染库和报表设计器GUI应用程序。但是好多使用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免费下载



标签:

本站文章除注明转载外,均为本站原创或翻译。欢迎任何形式的转载,但请务必注明出处,尊重他人劳动成果

文章转载自:慧都控件

登录慧都网发表评论登录


暂无评论...

为你推荐

  • 推荐视频
  • 推荐活动
  • 推荐产品
  • 推荐文章
  • 慧都慧问
相关厂商
相关产品
NCReport

用C++编写的强大、快速、多平台、容易使用的报表解决方案

在线客服 在线QQ 电话咨询
400-700-1020
在线客服系统
live chat