ActiveReports for .NET 18.0J
ブックマークの追加
ActiveReportsユーザーガイド > 基本操作 > セクションレポートの基本操作 > 対話的な操作 > ブックマークの追加

セクションレポートでは、Viewerコントロールの見出しマップの各フィールドに追加したブックマークはもちろんのこと、見出しマップのグループ、サブレポートにネストしたブックマークも表示することができます。また、実行時にも特定のブックマークを追加することができます。

基本的なブックマークを設定する

  1. Visual Studioのツールボックスから、TextBoxコントロールをDetailセクション上にドラッグ&ドロップします。
  2. レポートのDetailセクションをダブルクリックし、Detail_Formatイベントのイベント処理メソッドを作成します。
  3. ハンドラに次のコードを追加してブックマークを設定します。

Visual Basic

Visual Basicコード(Detail_Formatイベント内に貼り付けます)
コードのコピー
Me.Detail1.AddBookmark(textBox1.text)

C#

C#コード(Detail_Formatイベント内に貼り付けます)
コードのコピー
detail.AddBookmark(textBox1.Text);

ネストされたブックマークを設定する

  1. Visual Studioのツールボックスから、CustomerIDフィールドとContactNameフィールドをDetailセクション上にドラッグ&ドロップします。
  2. レポートのDetailセクションをダブルクリックし、Detail_Formatイベントのイベント処理メソッドを作成します。
  3. ハンドラに次のコードを追加してブックマークを設定します。

Visual Basic

Visual Basicコード(Detail_Formatイベント内に貼り付けます)
コードのコピー
Me.Detail1.AddBookmark(txtCustomerID.Text + "\" + txtContactName.Text)

C#

C#コード(Detail_Formatイベント内に貼り付けます)
コードのコピー
detail.AddBookmark(txtCustomerID.Text + "\\" + txtContactName.Text);

孫のブックマークをネストし、グループ化して使用する

  1. Visual Studioのツールボックスから、CityCustomerIDContactNameの各フィールドをDetailセクション上にドラッグ&ドロップします。
  2. レポートのDetailセクションをダブルクリックし、Detail_Formatイベントのイベント処理メソッドを作成します。
  3. ハンドラに次のコードを追加して、ContactNameフィールドにブックマークを設定し、CustomerIDフィールドのブックマーク内に各ContactNameをネストしてCityフィールドにCustomerIDをネストします。

    Visual Basic

    Visual Basicコード (Detail_Formatイベント内に貼り付けます)
    コードのコピー
    Me.Detail1.AddBookmark(txtCity.Text + "\" + txtCustomerID.Text + "\" + txtContactName.Text)

    C#

    C#コード (Detail_Formatイベント内に貼り付けます)
    コードのコピー
    this.detail.AddBookmark(txtCity.Text + "\\" + txtCustomerID.Text + "\\" + txtContactName.Text);
  4. デザイナ面を右クリックし、コンテキストメニューから[挿入]を選択して[グループヘッダ/フッタ]を追加します。[groupHeader1]セクションを選択し、[プロパティ]ウィンドウからDataFieldプロパティを「City」に設定します。
  5. レポートのグループヘッダセクションをダブルクリックし、groupHeader1_Formatイベントのイベント処理メソッドを作成します。
  6. ハンドラに次のコードを追加して、Cityグループの各インスタンスに対してブックマークを設定します。

    Visual Basic

    Visual Basicコード (groupHeader1_Formatイベント内に貼り付けます)
    コードのコピー
    Me.GroupHeader1.AddBookmark(txtCity.Text)

    C#

    C#コード (groupHeader1_Formatイベント内に貼り付けます)
    コードのコピー
    this.groupHeader1.AddBookmark(txtCity.Text);

親レポートとサブレポートのブックマークを組み合わせる

  1. [レポートエクスプローラ]から、親レポートのDetailセクション上にCustomerIDフィールドをドラッグ&ドロップします。
  2. Detailセクションをダブルクリックし、Detail_Formatイベントのイベント処理メソッドを作成します。
  3. ハンドラに次のコードを追加して、親レポートのCategoryIDフィールドの各インスタンスに対してブックマークを作成します。

    Visual Basic

    Visual Basicコード (親レポートのDetail_Formatイベント内に貼り付けます)
    コードのコピー
    Me.Detail1.AddBookmark(txtCustomerID.Text)

    C#

    C#コード (親レポートのDetail_Formatイベント内に貼り付けます)
    コードのコピー
    detail1.AddBookmark(txtCustomerID.Text);
  4. [レポートエクスプローラ]から、サブレポートのDetailセクション上にContactNameフィールドをドラッグ&ドロップします。 
  5. Detailセクションをダブルクリックし、Detail_Formatイベントのイベント処理メソッドを作成します。
  6. ハンドラに次のコードを追加して、サブレポートのContactNameフィールドの各インスタンスに対してブックマークを作成します。

     

    Visual Basic

    Visual Basicコード (サブレポートのDetail_Formatイベント内に貼り付けます)
    コードのコピー
    Me.Detail1.AddBookmark(CType(Me.ParentReport.Sections("Detail1").Controls("txtCustomerID"), TextBox).Text + "\" + Me.txtContactName.Text)

    C#

    C#コード (サブレポートのDetail_Formatイベント内に貼り付けます)
    コードのコピー
    this.detail1.AddBookmark(((TextBox)(this.ParentReport.Sections["Detail1"].Controls["txtCustomerID"])).Text + "\\" + this.txtContactName.Text);

実行時に特定のブックマークを追加する

実行時にブックマークのコレクションに特定のブックマークを作成して追加するには、レポートドキュメントのページのコレクションにブックマークを追加します。

注意:ページコレクションは、レポートを実行した後に作成されるので、次のコードをReportEndイベントまたはフォームで使用します。
  1. レポートの周囲にあるグレーの領域を右クリックし、コンテキストメニューから[プロパティ]を選択します。
  2. [プロパティ]ウィンドウにある[イベント]アイコンをクリックし、レポートで使用可能なイベントの一覧を表示します。
  3. ReportEndイベントをダブルクリックします。これにより、ReportEndイベントのイベント処理メソッドが作成されます。
  4. ハンドラに次のコードを追加して、ブックマークを追加します。

    Visual Basic

    Visual Basicコード(ReportEndイベント内に貼り付けます)
    コードのコピー
    Me.Document.Pages(0).AddBookmark("新規のブックマーク", 1)
    

    C#

    C#コード(ReportEndイベント内に貼り付けます)
    コードのコピー
    this.Document.Pages[0].AddBookmark("新規のブックマーク", 1);
    

ブックマークをViewerまたは[プレビュー]タブで表示する

  1. ツールボックスからViewerコントロールをWindowsフォーム上に配置します。
  2. レポートをViewerで表示するためにコードを追加します。詳細については、「レポートの表示」を参照してください。
  3. [F5]キーを押して、レポートを実行します。
  4. Viewerのツールバーで[サイドバー]ボタンをクリックし、左側にサイドバーを開きます。[見出しマップラベル]ボタンをクリックして、ブックマークの一覧を表示します。
関連トピック