すべて展開

すべて折りたたむ

セクションレポートでは、注釈を含むレポートをRDFファイルとして保存できます。実行時に注釈を追加することも可能です。

次の手順は、Visual Studioのプロジェクトにセクションレポート（コード）のテンプレートを既に追加したことを前提にしています。詳細は、「プロジェクトにレポートを追加する」を参照してください。

注意:

注釈は、Windowsフォーム用ビューワコントロールからの印刷時、もしくはRDFファイル（.NET形式のみ対応）への保存時のみ反映されます。
各種エクスポートには対応しません。注釈を含むレポートをPDFやExcelなどにエクスポートした場合、注釈は無視されます。

注釈を保存する

以下の手順は、ビューワに［注釈付きレポートを保存する］ボタンを追加し、注釈付きレポートをRDFファイルに保存する方法を説明します。

Visual Studioのツールボックスから、Buttonコントロールをビューワ上にドラッグします。
ボタンのTextプロパティを［注釈付きレポートを保存する］に設定します。
ボタンをダブルクリックし、Clickイベントのイベント処理メソッドを作成します。

ハンドラに次のコードを追加し、レポートをRDFファイルとして保存します。保存されたRDFファイルをビューワにロードする方法について、「RDFファイルの保存とロード」を参照してください。

Visual Basic

Visual Basicコード（Button_Clickイベント内に張り付けます）	コードのコピー
Me.Viewer1.Document.Save("C:\UserAnnotations.rdf")

C#コード（button_Clickイベント内に張り付けます）	コードのコピー
this.viewer1.Document.Save("C:\\UserAnnotations.rdf");

実行時に注釈を追加する

以下のサンプルコードでは、実行時に注釈を追加し、レポートデータと注釈をRDFファイルに保存する方法を説明します。

ビューワが配置されているFormのタイトルバーをダブルクリックし、Form_Loadイベントのイベント処理メソッドを作成します。

注釈を含むレポートをビューワに表示し、RDFファイルに保存するには、ハンドラに次のコードを追加します。

Visual Basic

Visual Basicコード（クラスの上に張り付けます）	コードのコピー
Imports GrapeCity.ActiveReports.Document.Section.Annotations

Visual Basicコード（Form_Loadイベント内に張り付けします）	コードのコピー
Dim rpt As New SectionReport1 'レポートを実行します。 rpt.Run() 'ビューワにドキュメントを設定します。 Me.Viewer1.Document = rpt.Document '注釈を作成し、プロパティ値を割り当てます。 Dim circle As New AnnotationCircle circle.Color = System.Drawing.Color.GreenYellow circle.Border.Color = System.Drawing.Color.Chartreuse '注釈を追加します。 circle.Attach(1,1) '画面位置 Me.Viewer1.Document.Pages(0).Annotations.Add(circle) 'サイズを設定します。この注釈は最初のページに作成されます。 circle.Height = 0.25 circle.Width = 0.50 '注釈を含むレポートをRDFファイルに保存します。 rpt.Document.Save("C:\AnnotatedReport.rdf")

Visual Basicコード（Form_Loadイベント内に張り付けします）

コードのコピー

   Dim rpt As New SectionReport1
   'レポートを実行します。
   rpt.Run()

   'ビューワにドキュメントを設定します。
   Me.Viewer1.Document = rpt.Document

   '注釈を作成し、プロパティ値を割り当てます。
   Dim circle As New AnnotationCircle
   circle.Color = System.Drawing.Color.GreenYellow
   circle.Border.Color = System.Drawing.Color.Chartreuse

   '注釈を追加します。
   circle.Attach(1,1) '画面位置
   Me.Viewer1.Document.Pages(0).Annotations.Add(circle)

   'サイズを設定します。この注釈は最初のページに作成されます。
   circle.Height = 0.25
   circle.Width = 0.50

   '注釈を含むレポートをRDFファイルに保存します。
   rpt.Document.Save("C:\AnnotatedReport.rdf")

C#コード（クラスの上に張り付けます）	コードのコピー
using GrapeCity.ActiveReports.Document.Section.Annotations;

C#コード（Form_Loadイベント内に張り付けします）	コードのコピー
SectionReport1 rpt = new SectionReport1(); //レポートを実行します。 rpt.Run(); //ビューワにドキュメントを設定します。 this.viewer1.Document = rpt.Document; //注釈を作成し、プロパティ値を割り当てます。 AnnotationCircle circle = new AnnotationCircle(); circle.Color = System.Drawing.Color.GreenYellow; circle.Border.Color = System.Drawing.Color.Chartreuse; //注釈を追加します。 circle.Attach(1,1); //画面位置 this.viewer1.Document.Pages[0].Annotations.Add(circle); //サイズを設定します。この注釈は最初のページに作成されます。 circle.Height = 0.25f; circle.Width = 0.50f; //注釈を含むレポートをRDFファイルに保存します。 rpt.Document.Save("C:\\AnnotatedReport.rdf");

概念

注釈