Borland Developer Studio 2006でQuickReport 4を使う

By: Hitoshi Fujii

Abstract: この記事では、Borland Developer Studio 2006でQuickReport 4を使うためのインストール/環境設定の方法を解説します。また、既存のQuickReportアプリケーションをマイグレーションするときに、同時に考慮しておかなければならない注意点を説明します。

QuickReportは、Delphi 7、C++Builder 6まで、標準のレポートツールとして製品にバンドルされていました。現在は、Rave Reportが標準添付になっていますが、過去の開発資産としてQuickReportアプリケーションを抱えているケースがあると思います。現在では、QBS Software社が、Borland Developer Studio(Delphi Win32、Delphi .NET、C++Builder)にも対応した、QuickReport 4 Professionalをリリースしており、これを利用することで、既存開発資産を有効活用することができます。

現在、Borland Developer Studio登録ユーザーの方は、QuickReport 4の機能限定版、QuickReport Standard(Delphi for Win32用のみ)を無償でダウンロードして利用することができるので、このソリューションを検討するよい機会です。

    QuickReportを使う

QBS Softwareが提供するQuickReport 4 Professionalは、QBS SoftwareのWebサイトから購入することができますが、日本の販売代理店からの購入も可能です。現在、ComponentSourceにて、取り扱い可能(ComponentSourceオンラインショップには登録されていません)なので、購入を検討されている方は、直接問い合わせをしてください。

最新バージョンの QuickReport Professionalがサポートしている開発環境

・Borland Delphi 5

・Borland Delphi 6

・Borland Delphi 7

・Borland Delphi 2005 for Windows (Win32)

・Borland Delphi 2005 for .NET (.NET)

・Borland Delphi 2006 for Windows (Win32)

・Borland Delphi 2006 for 20006 for .NET (.NET)

・Turbo Delphi 2006 Professional for Windows (Win32)

・Borland C++Builder 5

・Borland C++Builder 6

・Borland C++Builder 2006



QuickReport 4 Professionalには、QuickReportコンポーネントのソースコードも標準添付されているので、コンパイル済みのバイナリによるインストール、ソースコードをコンパイルしてのインストールのいずれも選択できます。コンポーネントのカスタマイズ、バグフィックスの適用などをタイムリーに行うには、後者の方法を推奨します。

QuickReport 4 Professionalには、Delphi Win32用、Delphi .NET用、C++Builder用といった、それぞれのパーソナリティ用のインストールモジュールが用意されています。パーソナリティごとに、モジュールの構成、インストールディレクトリなどが異なりますので、注意してください。また、複数のパーソナリティを混在させる場合にも、注意が必要です。

Delphi Win32

Delphi .NET

C++Builder

セットアップ

QR406PD2006.EXE

QR406NET2006.EXE、QR4VCLNETD2006.EXE

※ QR4VCLNETD2006.EXE の方が新しい

QR406C2006.EXE

インストールディレクトリ

コンパイル済みモジュール、ソースファイル、リソースファイル、プロジェクトファイル:
C:\Program Files\QuickReportsXI

コンパイル済みパッケージ:
C:\Program Files\QuickReportsXI\bpl

ヘルプファイル:
C:\Program Files\QuickReportsXI\help

ソース、リソース、コンパイル済みモジュール等のファイル:
C:\Program Files\Borland\QuickReport4NET

ヘルプファイル:
C:\Program Files\Borland\QuickReport4NET\help

ヘッダを含むソース、リソース、プロジェクトファイル:
C:\Program Files\Borland\BDS\4.0\quickrpt

リソースファイル:
C:\Program Files\Borland\BDS\4.0\quickrpt\quickrpt

リソースファイル:
C:\Program Files\Borland\BDS\4.0\quickrpt\lib\obj

空:
C:\Program Files\Borland\BDS\4.0\quickrpt\include

ヘルプファイル:
C:\Program Files\Borland\BDS\4.0\quickrpt\help

コンパイル済みパッケージ:
C:\Program Files\Borland\BDS\4.0\projects\BPL

Lib ファイル、bpi ファイル:
C:\Program Files\Borland\BDS\4.0\projects\lib



QuickReportをインストールする方法については、以下の手順を参照してください。

    Delphi Win32へのインストール

コンパイル済みのモジュールをインストールするには、DelphiのIDEから、[コンポーネント|パッケージをインストール|追加]メニューで、デザイン時パッケージをインストールします。インストールするファイルは、C:\Program Files\QuickReportsXI\bpl\QR4DesignD2006.bpl です。次に、[プロジェクト|デフォルトオプション|Delphi for Win32]メニューを実行し、デフォルトプロジェクトオプションを設定します。[ディレクトリ/条件]の[検索パス]、[デバッグ用ソースパス]に、C:\Program Files\QuickReportsXI を追加します。

ソースコードからインストールするには、C:\Program Files\QuickReportsXI\bpl\QR4DesignD2006.dpk とC:\Program Files\QuickReportsXI\bpl\QR4RunD2006.dpkを、 Delphi Win32 パーソナリティで開いて、コンパイルします。コンパイルが完了したら、設計時パッケージQR4DesignD2006.dpkをプロジェクトマネージャ上で選択して右クリックし[インストール]メニューを実行します。以上で、ツールパレットにQuickReportコンポーネントが追加されます。

Hide image
qr_fig01

図1 -ツールパレットにQReportタブとコンポーネントが追加された

    Delphi .NETへのインストール

Delphi .NETで、ソースコードからインストールするには、インストール直後にインストールディレクトリに展開されているQR4DesignD2006NET.dpk、QR4Run2006NET.dpk を Delphi .NET パーソナリティで開いて、コンパイルします。次に、[コンポーネント|インストール済み .NET コンポーネント]メニューを実行し、QR4DesignD2006NET.dll を .NET VCL コンポーネントとしてインストールします。

    C++Builderへのインストール

C++Builderで、ソースコードからインストールする場合は、少し複雑です。まず、旧バージョンのディレクトリマッピングをベースとした、以下のディレクトリ内のファイルを全て削除します。これは、現在のバージョンで、プロジェクトディレクトリ等の位置が異なるために不整合が発生しているものです。

C:\Program Files\Borland\BDS\4.0\projects\BPL

C:\Program Files\Borland\BDS\4.0\projects\lib

※ \projects 以下のディレクトリを含めて削除してもよい

次に、実行時パッケージの C:\Program Files\Borland\BDS\4.0\quickrpt\QR4RunC2006.bdsproj と、設計時パッケージのC:\Program Files\Borland\BDS\4.0\quickrpt\QR4DesignC2006.bdsprojを開きます。プロジェクトの管理を容易にするために、これらのプロジェクトをまとめるプロジェクトグループを作成してもよいでしょう。

次に、プロジェクト設定を変更します。これは、実行時パッケージ、設計時パッケージそれぞれに行います。

Hide image
qr_fig02

図2 – プロジェクトオプション

[プロジェクト|オプション]メニューを実行し、[パスカルコンパイラ(DCC32)|パスと定義]を選択し、[パスと定義]の各設定から不正なパスを削除します。そして、次の2つに適切な値を設定します。

ユニット検索パス

$(BDS)\lib;$(BDS)\lib\obj

{$I <include>} 検索パス

$(BDS)\quickrpt\quickrpt



次に、Qrabsdatas.hpp ファイルの94行目を修正します。これは、定義の大文字/小文字に誤りがあるためです。

誤):__property Fielddefs ;
正):__property FieldDefs ;

パッケージプロジェクトをコンパイルするときには、実行時パッケージからビルドするほうが簡単です。設計時パッケージは、実行時パッケージに依存関係があるため、この関係を定義すれば、コンパイル順序を気にする必要はありません。

コンパイルが成功したら設計時パッケージ QR4DesignC2006.bpl をインストールします。そして、プロジェクトのデフォルト設定でQuickReportが有効になるように、[プロジェクト|デフォルトオプション|C++Builder]メニューを実行し、[パスと定義|インクルードファイルの検索パス]に「$(BDS)\quickrpt」を追加しておきます。

以上で、QuickReportを利用できるようになります。

Hide image
qr_fig03

図3 - QuickReportをインストールしたBorland Developer Studio 2006

    Standard vs. Professional

旧バージョンIDEに添付されていたQuickReportと、最新のQuickReport 4(単独製品版のProfessionalとBDS登録ユーザー向けのStandard)に搭載されたコンポーネント一覧を以下に示します。

QuickReport 3.09 BE

QuickReport 4.06 Standard

QuickReport 4.06 Professional

TQuickRep

TQRSubDetail

TQRStringsBand

TQRBand

TQRChildBand

TQRGroup

TQRLabel

TQRDBText

TQRExpr

TQRSysData

TQRMemo

TQRExprMemo

TQRRichText

TQRDBRichText

TQRShape

TQRImage

TQRDBImage

TQRCompositeReport

TQRPreview

TQRTextFilter

TQRCSVFilter

TQRHTMLFilter

TQuickAbstractRep

TQRLoopBand

TQRPDFFilter

TQRXMLSFilter

TQRExcelFilter

TQRRTFFilter

TQRWMFFilter

TQREditor

TQRGrImage