ActiveReports 2.0JとActiveReports for .NETの違い

ここでは、ActiveReports 2.0JとActiveReports for .NET 9.0Jのセクションレポートとの違いについて説明します。

セクション・コントロールの相違点

対比表

ActiveX製品と.NET製品のコントロールの対比表です。

ActiveX製品	.NET製品
Field	TextBox
Label	Label
CheckBox	CheckBox
Image	Picture
Line	Line
OleObject	OleObject
PageBreak	PageBreak
RichEdit	RichTextBox
Shape	Shape
SubReport	SubReport
ActiveXコントロール（Barcode含む）	×（※１）
Frame	×（※２）
ADOデータコントロール	OLEDataSource（※３）
XMLデータコントロール	XMLDataSource（※４）
RDOデータコントロール	×
DAOデータコントロール	×
－	ChartControl（※５）
－	CrossSectionBox（※６）
－	CrossSectionLine（※７）
－	ReportInfo（※８）

※１　基本クラスである「ARControl」として移行されるのみです。

※２　Frame内に配置されたコントロールは移行されます。

※３　デザイン時に設定されているSource（SQL）とConnectionStringプロパティのみ、移行されます。

※４　デザイン時に設定されているFileURL／RecordSetPatternプロパティのみ、移行されます。

※５　２D／３Dグラフを描画するコントロールです。

※６　複数のセクションをまたいで長方形を描画するコントロールです。

※７　複数のセクションをまたいで直線を描画するコントロールです。

※８　レポートの実行日時やページ番号・ページ総数を指定した書式で描画するコントロールです。

.NET製品で名称などが変更された主なプロパティ

	プロパティ名
コントロール・セクション名(.NET製品)	ActiveX製品	.NET製品	備考
GroupHeader	GrpKeepTogether	GroupKeepTogether	型自体が異なります
	Repeat	RepeatStyle	型自体が異なります
CheckBox・TextBox・Label 共通	WordWrap	WrapMode	型自体が異なります
TextBox	DataValue	Value
	SummaryDistinctField	DistinctField
CheckBox	Alignment	CheckAlignment	型自体が異なります
	Value	Checked
Picture	Picture	Image	型自体が異なります
Shape	Shape	Style
SubReport	Object	Report

.NET製品で新たに追加された主なプロパティ

コントロール・セクション名（.NET製品）	プロパティ名	説明
GroupHeader	ColumnGroupKeepTogether	グループを同じカラムで１つのブロックとする
Detail	RepeatToFill	空白行を追加する
CheckBox・TextBox・Label 共通	Padding	コントロール内の余白を設定する
TextBox・Label 共通	CharacterSpacing	文字ピッチ（間隔）をポイント単位で設定する
	LineSpacing	行間をポイント単位で設定する
	TextJustify	均等割付を設定する
	VerticalText	字形を縦書きに最適化する
	ShrinkToFit	コントロールサイズにあわせて文字を縮小する
Picture	Description	Pictureの視覚的な外観の説明を設定する（Htmlエクスポート時に有効）
Line	AnchorBottom	罫線の末端を隣接したセクションまで引く
Shape	RoundingRadius	角丸四角形の丸みをパーセント単位で設定する
SubReport	CloseBorder	サブレポートが複数ページをまたぐ時、罫線で閉じるかどうかを設定する

上記以外にも.NET製品で新たに追加されたプロパティや変更されたプロパティはありますが、ここでは使用頻度が高いと考えられるプロパティのみを記載しています。

また、OleObjectコントロールとRichTextBox（RichEdit）コントロールは、プロパティやメソッドが大幅に変更されています。これらのコントロールを使用している場合には、.NET製品のヘルプの「クラスライブラリリファレンス」などをご参照の上、必要に応じて設定内容を調整してください。

エクスポート機能の相違点

.NET製品のエクスポート機能は、.NET製品のレポートをエクスポートすることを前提に新規に開発したものです。ActiveX製品と比較して、さまざまな機能強化が行われるとともにプロパティやイベントなどに相違があります。

詳細については、以下の内容を参照してください。

PDFエクスポート

内容	ActiveX製品	.NET製品
PDFバージョン	1.1～1.3	1.1～1.7
PDF内画像の画質設定	JPGQualityプロパティで設定（1～100）	ImageQuality（低中高の３段階）とImageResolution（75～2400dpi）プロパティで設定
日本語フォントの非埋込み	×（常に埋め込み）	○（※1、Standardは常に埋め込み）
日本語フォントの太字	×（通常の太さで出力）	○（※1）
外字	×（出力されません）	○（※1）
電子署名・タイムスタンプ	×	○：Signatureプロパティ（※1）
GIFやメタ画像の透過要素	×（非透過状態になります）	○
ブックマークの出力	○：OutputTOCAsBookmarksプロパティ	○：ExportBookmarksプロパティ
文書プロパティの設定	×	○：Optionsプロパティ（※2）
文書の表示状態の設定	△：ShowBookmarksInAcrobat（ブックマーク表示のみ設定可）	○：Options.DisplayModeプロパティ（※3）
ウィンドウの表示設定	×	○：Optionsプロパティ（※4）
UIの設定	×	○：Optionsプロパティ（※5）
印刷専用	×	○：Options.OnlyForPrintプロパティ
進行状況の取得	○：OnProgressイベント	×

※1　Professional のみ有効・設定可能です。

※2　タイトル（Title）、作成者（Author）、サブタイトル（Subject）、キーワード（Keywords）、アプリケーション（Application）の５項目が設定可能です。

※3　ブックマーク・サムネール・フルスクリーン・なしの４種類が設定可能です。

※4　画面中央への表示可否（CenterWindow）や表示サイズ（FitWindow）、タイトルバーの表示内容（DisplayTitle）が設定可能です。

※5　メニューバー(HideMenubar)・ツールバー（HideToolbar）・UI要素（HideWindowUI）の表示可否が設定可能です。

Excelエクスポート

Excelエクスポート（XlsExportクラス）

内容		ActiveX製品	.NET製品
ファイル保存関連	ファイルバージョン	Excel 95／97	Excel 95／97／2007（OpenXML）
レイアウト関連	セル内余白の設定	○：BorderSpaceプロパティ	×
	列の出力調整	○：DoubleBoundariesプロパティ	×
	ページ区切りの生成	○：GenPageBreaksプロパティ	△：（常にページ区切りを出力）
	要素・余白間の設定	○：ShowMarginSpaceプロパティ	×
	拡大縮小印刷の設定	○：SizeToFitプロパティ	×
	垂直方向のスペース除去	○：TrimEmptySpaceプロパティ	○：RemoveVerticalSpaceプロパティ
	バージョンの設定	○：Versionプロパティ	○：FileFormatプロパティ
	グリッド線の表示設定	×（表示固定）	○：DisplayGridLinesプロパティ
	セルの結合設定	×	○：UseCellMergingプロパティ
	カラーパレット設定	×（常にワークブックにパレットを保持）	○：UseDefaultPaletteプロパティ
印刷関連	用紙サイズの設定	×（Excelのデフォルト設定に依存）	○：PageSettings.PaperSizeプロパティ
	用紙方向の設定	×（Excelのデフォルト設定に依存）	○：PageSettings.Orientationプロパティ
セキュリティ関連	読み取りパスワード	×	○：Security.Passwordプロパティ
	書き込みパスワード	×	○：Security.WritePasswordプロパティ
	読み取り推奨	×	○：Security.ReadOnlyRecommendedプロパティ
	ユーザー名の設定	×	○：Security.ProtectedByプロパティ
進行状況の取得		○：OnProgressイベント	×

Excelエクスポート（SpreadBuilder API）

内容		ActiveX製品	.NET製品
実装方法		SpreadBuilderオブジェクトで制御	Workbookオブジェクトで制御
ファイル保存関連	ファイルバージョン	Excel 95／97	Excel 95／97／2007（OpenXML）
	エラーの事前チェック	○：GetSaveCapsメソッド	×（Exceptionによる処理）
レイアウト関連	セルの結合・分割	×	○：Merge・UnMergeメソッド
	グリッド線の表示設定	×（常に表示する）	○：DisplayGridLinesプロパティ
	テキストの取り消し線	×	○：FontStrikeOutプロパティ
	範囲指定による書式設定	×	○：（Cellsクラスを使用）
	カラーパレット設定	×（常にワークブックにパレットを保持）	○：UseDefaultPaletteプロパティ
印刷関連	設定方法	DDSheetオブジェクトで設定	PageSetupクラスで設定
	白黒印刷の設定	×	○：BlackAndWhiteプロパティ
	簡易印刷の設定	×	○：Draftプロパティ
	拡大縮小印刷の設定	○：SizeToFitプロパティ	○：FitToPageプロパティ
	（縦方向のページ数）	×（１ページ固定）	○：FitToPagesTallプロパティ
	（横方向のページ数）	×（１ページ固定）	○：FitToPagesWideプロパティ
	倍率	×（100%固定）	○：Zoomプロパティ
	用紙サイズの設定	×（Excelのデフォルト設定に依存）	○：PaperSizeプロパティ
	先頭ページ番号の設定	×（自動固定）	○：FirstPageNumberプロパティ
	ヘッダの高さの設定	×	○：HeaderMarginプロパティ
	フッタの高さの設定	×	○：FooterMarginプロパティ
	ページの方向の設定	×（”左から右”固定）	○：Orderプロパティ
	コメントの印刷設定	×（”なし”固定）	△：PrintNotesプロパティ ※”画面表示イメージ”のみ設定可
セキュリティ関連	読み取りパスワード	×	○：Passwordプロパティ
	書き込みパスワード	×	○：WritePasswordプロパティ
	読み取り推奨	×	○：ReadOnlyRecommendedプロパティ
	ユーザー名の設定	×	○：ProtectedByプロパティ
	ブックの保護パスワード	×	○：ProtectWorkbookPasswordプロパティ

TIFFエクスポート

内容		ActiveX製品	.NET製品
圧縮形式の指定方法		使用するメソッドで決定	CompressionSchemeプロパティで設定
設定可能な圧縮形式	なし	×	○：”None”
	Lzw	×	○：”Lzw”
	Rle（PackBits）	○：Export・ExportTIFFメソッド	○：”Rle”（ただし、白黒固定）
	CCITT Group3	○：FaxExportCITT3メソッド	○：”Ccitt3”
	CCITT Group4	○：FaxExportメソッド	○：”Ccitt4”
ディザリングの設定		○：FaxExport・FaxExportCITT3 メソッドのみ可（※1）	○：Ditherプロパティ（※2）
解像度の設定		○：ExportTIFFメソッドのみ可	○：DpiX、DpiYプロパティ
進行状況の取得		○：OnProgressイベント	×

HTMLエクスポート

内容		ActiveX製品	.NET製品
ファイル出力関連	画像格納先の設定	○：AuxOutputPathプロパティ	×（常にHTMLと同じパスに出力）
	CSSファイルの生成有無	○：CreateCSSFileプロパティ	×（スタイルはHTML内に記述）
	出力ファイル名	FileNamePrefixプロパティで指定	Exportメソッドの引数で指定
	ファイル出力先の設定	HTMLOutputPathプロパティで指定	Exportメソッドの引数で指定
	JPEGの圧縮率の設定	○：JPEGQualityプロパティ	×
	MHT形式での出力	○：MHTOutputプロパティ	×
	複数ページ時の出力形式の設定	MultiPageOutputプロパティで設定	MultiPageプロパティで設定
	ブックマークの出力	○：TableOfContentsプロパティ（※1）	○：BookmarkStyleプロパティ（※2）
HTML・レイアウト関連	HEADタグ直前のコード挿入	○：HeadExtraInnerTextプロパティ	×
	HTMLバージョンの指定（※3	○：HTMLVersionプロパティ	○：OutputTypeプロパティ（※4）
	垂直方向のスペース除去	×	○：RemoveVerticalSpaceプロパティ
	ページ出力直前のHTML追記	○：ExportPageStartイベント	×
	ページ出力直後のHTML追記	○：ExportPageEndイベント	×
進行状況の取得		○：OnProgressイベント	×

※1　“なし”、”<DL>タグ形式”、”DHTML形式”、”XML形式”のいずれかから設定可能です。

※2　“なし”、”アンカータグ形式”のいずれかから設定可能です。

※3　“HTML3.2”と” HTML4.0 Transitional”（デフォルト）から選択可能です。

※4　<!DOCTYPE>による宣言は行わず、出力内容が上記に準拠したものになるのみです。

Textエクスポート

内容	ActiveX製品	.NET製品
エンコーディングの設定	△：Unicodeプロパティ（※1）	○：Encodingプロパティ
進行状況の取得	○：OnProgressイベント	×

RTFエクスポート

内容	ActiveX製品	.NET製品
進行状況の取得	○：OnProgressイベント	×

バーコードコントロールの相違点

ActiveX製品では、ActiveXコントロールとしてバーコードを出力しましたが、.NET製品ではBarcodeコントロールが用意されております。出力可能なバーコードの形式や設定可能なプロパティについて、ActiveX製品と相違があります。詳細については、以下の内容を参照してください。

対応しているバーコード形式の対比表

内容	ActiveX製品	備考
CODE39	Code39、Ansi39	※２
CODE39(フルアスキー)	Code39x、Ansi39x
CODE49	Code49
CODE93	Code_93	英字の大文字、%、$、*、.、+、-、スペース、数字のみ設定可能
CODE93	Code93x	ASCII文字セットの文字すべてを設定可能
CODE128	Code_128auto	※３
	Code_128_A	CODE-A固定形式
	Code_128_B	CODE-B固定形式
	Code_128_C	CODE-C固定形式
JAN8	EAN_8
JAN13	EAN_13
EAN128	UCCEAN128	※３、４、５
EAN128	EAN128FNC1	※３、４、５
ITF	Code25intlv	※６、７
POSTNET5、9、11	PostNet	データ桁数に依存せずにシンボルを生成可能
UPC/A	UPC_A
UPC/E	UPC_E0、UPC_E1	※８
UPC/E Addon2、Addon5	UPC_E0、UPC_E1
NW-7(CODABAR)	Codabar
カスタマバーコード	JapanesePostal
Code49（※１）	Code49
PDF417（※１）	PDF417
QRCode（※１）	QRCode	モデルはQRCodeOptions.Modelプロパティで設定
－	Code_2_of_5	Code 2 of 5 形式
－	Matrix_2_of_5	Matrix 2 of 5形式
－	MSI	MSIコード形式
－	RM4SCC	Royal Mail RM4SCC形式
－	GS1 データバー	※９
－	IntelligentMail	Intelligent Mail Barcode 形式
－	DataMatrix	Data Matrix形式

※１　オプション製品「GrapeCity Barcode 2.0J」をご利用の場合のみ、使用可能な形式です。

※２　Code39（Code39x）とAnsi39（Ansi39x）は、バーコードの構成仕様は同一ですが、ナローバーとワイドバーのデフォルトの幅比率が異なります。前者が１：２であるのに対し、後者は１：３です。

※３　CODE128のスタートキャラクタの設定ロジックが、ActiveX製品と.NET製品で異なります。

※４　CODE128形式で、コードセットの切り替えを任意に行う機能はありません。

※５　CODE128（EAN128）形式で、FNC2～FNC4を任意の場所に挿入する機能はありません。（ただし、"EAN128FNC1"についてのみ、FNC1の挿入に対応しています。）

※６　チェックディジットは自動的に算出されません。.NET製品ではチェックディジットを付加した値を設定する必要があります。

※７　ベアラバーの出力には対応していません。

※８　「UPC_E0」はUPCシンボルのゼロ圧縮タイプで、数字のみ設定可能な形式です。「UPC_E1」は一般的に小売店の棚札に使用される形式で、数字6桁が有効な形式です。

※９　設定可能な「GS1 DataBar」の形式は、以下の７つです。

GS1 DataBar／GS1 DataBar Truncated／GS1 DataBar Stacked／
　　　GS1 DataBar Stacked Omnidirectional／GS1 DataBar Expanded／
　　　GS1 DataBar Expanded Stacked／GS1 DataBar Limited　

.NET製品が対応していない主なActiveX製品のプロパティ

※上記以外にも.NET製品に存在しないプロパティは存在しますが、生成されるバーコードシンボルに影響するプロパティのみ記載しています。

プロパティ名	説明
BarRatio	バーの比率を設定（NWRatioプロパティで細モジュールと太モジュールの相対的な幅比率を1:2～1:3の範囲で設定することは可能です。）
LongModuleSize	太モジュール幅を設定
TargetDpiX	出力先のＸ方向の解像度を設定
TargetDpiY	出力先のＹ方向の解像度を設定

ActiveReport オブジェクトについて

ActiveX製品のレポートの基本となるActiveReportオブジェクトはレポートのレイアウト情報やエンジンだけではなく、ビューワ機能も含まれていましたが、.NET製品では、セクションレポートの基本クラスであるSectionReportクラスとビューワ機能を提供するViewerクラスに再構成されています。また、生成されたページ情報をActiveX製品ではPagesクラスに格納していましたが、.NET製品ではDocumentクラスと PagesCollectionクラスに再構成されています。こうした構成変更に伴い、プロパティやメソッド、イベントなども変更されています。主な変更内容については、以下の一覧を参照してください。

プロパティの相違点

ActiveX製品	.NET製品		備考
	クラス	プロパティ名
AllowSplitters	Viewer	AllowSplitter
documentName	SectionDocument	Name
PageBorder	×	×	※1
Pages	SectionDocument	Pages	※2
Printer	SectionDocument	Printer
RulerVisible	×	×	ルーラーは存在しません。
ShowMessages	×	×	※3
ScriptDebuggerEnabled	SectionReport	EnableScriptDebugging
Status	SectionReport	State
TOC	SectionDocument	Bookmarks
TOCEnabled	TOCPanel（Viewer.Sidebar）	Enabled
TOCVisible	TOCPanel（Viewer.Sidebar）	Visible	※４
TOCWidth	Sidebar(Viewer)	Width
Toolbar	Viewer	Toolbar
ToolbarVisible	ToolStrip (Viewer.Toolbar)	Visible
Zoom	Viewer	Zoom

※1 CrossSectionBoxコントロールなどで枠線を描画してください。

※2 ActiveX製品ではCanvasオブジェクトの集合ですが、.NET製品ではDocument.Pageのコレクションです。

※3 .NET製品ではエラーが発生した場合、例外がスローされます。Try～Catchステートメントなどを使用して、独自にエラー処理を実装してください。

※4 見出しの表示にはViewer.SidebarオブジェクトのToggleVisibilityメソッドを使用します。

メソッドの相違点

	.NET製品
ActiveX製品	クラス	メソッド名	備考
Export	各エクスポートフィルタ	Export
PageSetup	×	×	※1
PrintReport	Document	Print
Refresh	×	×	※2

※1 .NET標準の PageSetupDialogクラスなどを使用して、独自に実装してください。

※2 DocumentプロパティやLoadDocumentメソッドを使用して、レポートドキュメントを再設定してください。

イベントの相違点

	.NET製品
ActiveX製品	クラス	イベント名	備考
Error	×	×	※1
FindProgress	Viewer	Find
HyperLink	Viewer	HyperLink
PromptDialogClosed	SectionReport	ParameterUIClosed
TOCClick	Viewer	TableOfContentsClick
TOCSelChange	Viewer	TableOfContentsSelectedIndexChanged
ToolbarClick	×	×	※2

※1 .NET製品ではエラーが発生した場合、例外がスローされます。Try～Catchステートメントなどを使用して、　独自にエラー処理を実装してください。

※2 Viewer.Toolbar.ToolStripクラスを使用して、独自の処理を実装する必要があります。詳しくは「Viewerコントロールのカスタマイズ」を参照してください。