Viewerコントロールのカスタマイズ

ActiveReportsでは、Windowsフォーム上で使用されるViewerコントロールを使用し、レポート出力をカスタムプレビューフォームで表示できます。ビューワでは、マウスモードまたはタッチモードのツールバーの変更またはプレビューフォームへのカスタムメニューコマンドの追加ができます。例えば、以下のサンプルコードは、タッチモードのツールバーのみ、マウスモードのツールバーのみ、および、タッチモードとマウスモードのツールバーの両方をカスタマイズする方法を説明します。

基本的なプレビューのフォームを作成する

Visual Studioのプロジェクトに新規のWindowsフォームを追加します。
Visual Studioツールボックスにある［ActiveReports 9］タブからフォーム上にViewerコントロールをドラッグします。ツールボックスに、Viewerコントロールが表示されていない場合は、「ActiveReportsコントロールを追加する」を参照してください。
Viewerコントロールを選択し、［プロパティ］ウインドウからDockプロパティを「Fill」に設定します。
［プロジェクト］メニューから、［新しい項目の追加］を選択します。
［ActiveReport 9.0J セクションレポート（コード）］を選択し、［追加］ボタンをクリックします。
フォームのタイトルバーをダブルクリックしてForm_Loadイベントを作成します。

ハンドラに次のコードを追加し、Viewerでレポートを表示します。

Visual Basic

［F5］キーを押して、プロジェクトを実行します。

Visual Basicコード（Form_Loadイベント内に貼り付けます）	コードのコピー
Dim rpt as new SectionReport1 Viewer1.LoadDocument(rpt)

C#コード（Form_Loadイベント内に貼り付けます）	コードのコピー
SectionReport1 rpt = new SectionReport1(); viewer1.LoadDocument(rpt);

マウスモードツールバーのみのカスタマイズ

上記の手順で作成したプロジェクトに、Windowsフォームを1つ追加し、名前を「frmPrintDlg」に変更します。
「frmPrintDlg」にLabelコントロールを追加し、Textプロパティを「これはカスタム印刷ダイアログです。」に変更します。
「frmPrintDlg」にButtonコントロールを追加し、Textプロパティを「OK」に変更します。
Viewerコントロールを追加したフォームのタイトルバーをダブルクリックしてForm_Loadイベントへ移動します。

Form_Loadイベントに以下のコードを追加し、デフォルトの印刷ボタンを削除し、独自のボタンを追加します。

Visual Basic

Visual Basicコード（Form_Loadイベント内に貼り付けます）	コードのコピー
'デフォルトの印刷のボタンを削除します。 Viewer1.Toolbar.ToolStrip.Items.RemoveAt(2) '余分なセパレーターを削除します。 Viewer1.Toolbar.ToolStrip.Items.RemoveAt(1) 'カスタムボタンを作成します。 Dim tsbPrint As New ToolStripButton("印刷") Viewer1.Toolbar.ToolStrip.Items.Add(tsbPrint) 'カスタムボタン用のClickイベントハンドラを作成します。 AddHandler tsbPrint.Click, AddressOf tsbPrint_Click

C#コード（Form_Loadイベント内に貼り付けます）	コードのコピー
//デフォルトの印刷のボタンを削除します。 viewer1.Toolbar.ToolStrip.Items.RemoveAt(2); //余分なセパレーターを削除します。 viewer1.Toolbar.ToolStrip.Items.RemoveAt(1); //カスタムボタンを作成します。 ToolStripButton tsbPrint = new ToolStripButton("印刷"); viewer1.Toolbar.ToolStrip.Items.Add(tsbPrint); //カスタムボタン用のClickイベントハンドラを作成します。 tsbPrint.Click += new EventHandler(tsbPrint_Click);

Loadイベントの下のフォームクラスに以下のコードを追加し、ユーザーがカスタムの［印刷］ボタンをクリックした際に、frmPrintDlgが表示されるようにします。

Visual Basic

プロジェクトを実行するには、［F5］キーを押下し、Viewer上にカスタム印刷ボタンを表示します。

Visual Basicコード（Form_Loadイベントの下に貼り付けます）	コードのコピー
'カスタムボタンのClickイベントを作成し、カスタム印刷ダイアログを呼び出します。 Private Sub tsbPrint_Click(sender As Object, e As EventArgs) Me.CustomPrint() End Sub 'カスタム印刷ダイアログを呼び出します。 Private Sub CustomPrint() Dim _printForm As New frmPrintDlg() _printForm.ShowDialog(Me) End Sub

C#コード（Form_Loadイベントの下に貼り付けます）	コードのコピー
//カスタムボタンのClickイベントを作成し、カスタム印刷ダイアログを呼び出します。 void tsbPrint_Click(object sender, EventArgs e) { this.CustomPrint(); } //カスタム印刷ダイアログを呼び出します。 private void CustomPrint() { frmPrintDlg _printForm = new frmPrintDlg(); _printForm.ShowDialog(this); }

タッチモードツールバーのみのカスタマイズ

Visual Basic（Form Loadイベント内に貼り付けます）	コードのコピー
Dim zoomOutButton = viewer1.TouchModeToolbar.ToolStrip.Items(8) zoomOutButton.Visible = true

C#（Form Loadイベント内に貼り付けます）	コードのコピー
var zoomOutButton = viewer1.TouchModeToolbar.ToolStrip.Items[8]; zoomOutButton.Visible = true;

注意: マウスモードでのカスタマイズはタッチモードには適用されません。その逆も同じです。

ToolStripのツールバーから任意のボタンを削除できます。この例では、テキストのあるボタンのみを追加しましたが、アイコンまたはアイコンと共にテキストも追加することができます。詳細は、「Windowsフォーム用のビューワの使用」を参照してください。

概念

Windowsフォーム用ビューワのカスタマイズ