注釈の追加と保存

全て展開

すべて折りたたむ

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

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

注意:

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

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

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

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

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コード（クラスの上に張り付けます）	コードのコピー
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");

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");