バージョン

WinGanttView コントロールの印刷版をカスタマイズする

トピックの概要

目的

このトピックでは InitializeGanttView イベントを使用して WinGanttView コントロールの印刷版をカスタマイズする方法についてコード例を用いて説明します。

必要な背景

以下の表に、このトピックを理解するための前提条件として求められるトピックをリストします。

トピック 目的

WinGanttViewPrintDocument™ コンポーネントの機能を紹介します。

本トピックの内容

このトピックには次のセクションがあります。

WinGanttView コントロールの印刷版のカスタマイズ - 概念的概要

概要

WinGanntView コントロールを利用するにあたり、画面上での表示にはいっさいの影響を与えることなく、印刷版の表示のみ変更を加えることをお勧めします。これは、UltraGanttViewPrintDocument の InitializeGanttView イベントを利用することによって実現できます。

UltraGanttViewPrintDocument コンポーネントは、UltraGanttView コントロールのインスタンスを作成し、プリンターにコントロールの情報を提供します。UltraGanttView コントロール インスタンスが作成されると、まず GanttView プロパティに応じて初期化が行われ、次に InitializeGanttView イベントが呼び出されてコントロールのさらなるカスタマイズが行われます。このイベントを利用することにより、コントロールの初期状態や画面上の表示を変えることなく、UltraGanttView コントロールの印刷版のみ表示を変えることができます。

Note
注：

印刷時に作成される UltraGanttView インスタンスは、画面表示用 UltraGanttView コントロールの UltraCalendarInfo™ および UltraCalendarLook™ コンポーネントを共有します。このため、InitializeGanttView イベント内で CalendarInfo または CalendarLook プロパティを変更した場合、画面表示用と印刷用の両方の UltraGanttView コントロールに影響します。各種タスクは CalendarInfo および ActiveTask オブジェクトに保管されているため、個別タスクのプロパティを変更した場合にも影響します。

サポートされるカスタマイズ

WinGanttView コントロールの印刷版は、以下のカスタマイズが可能です。

  • 画面上では表示されているが、印刷版には表示したくない列を隠します。

  • 画面上では表示されていないが、印刷版には表示したい列を表示します。

  • 列の順序の変更

  • インクの消費量を抑えるために背景色を白に変える等、外観上の変更をします。

WinGanttView コントロールの印刷版のカスタマイズ - コード例

説明

以下のコードは、UltraGanttView コントロールの画面上での表示に影響を与えずに、印刷版の表示を変更します。

このサンプル コードでは、印刷版の UltraGanttView コントロールの Resource Names 列の位置を変更し、 Resource Names 列のセルの外観を変えます。

プレビュー

WinGanttView コントロールの画面上の表示 (上) と、サンプル コードによってカスタマイズされた印刷版の表示 (下) を以下で比較しています。

Customizing the Print Version of the WinGanttView Control 01.png
Customizing the Print Version of the WinGanttView Control 02.png

コード

Visual Basic の場合:

Private Sub ultraGanttViewPrintDocument1_InitializeGanttView(sender As Object, e As Infragistics.Win.UltraWinGanttView.Printing.InitializeGanttViewEventArgs)
      '  ‘Resource Names’ 列の位置を変更します
      e.Control.GridSettings.ColumnSettings(TaskField.Resources).VisiblePosition = 1
'  ‘Resource Names’ 列のセルの外観を変更します
e.Control.GridSettings.ColumnSettings(TaskField.Resources).CellAppearance.BackColor = Color.White
End Sub

C# の場合:

private void ultraGanttViewPrintDocument1_InitializeGanttView(object sender, Infragistics.Win.UltraWinGanttView.Printing.InitializeGanttViewEventArgs e)
{
    //  ‘Resource Names’ 列の位置を変更します
    e.Control.GridSettings.ColumnSettings [TaskField.Resources].VisiblePosition = 1;
 //  ‘Resource Names’ 列のセルの外観を変更します
    e.Control.GridSettings.ColumnSettings[TaskField.Resources].CellAppearance.BackColor = Color.White;
}

トピック

以下のトピックでは、このトピックに関連する情報を提供しています。

トピック 目的

WinGanttViewPrintDocument™ コンポーネントの機能を紹介します。

このトピックでは theWinGanttViewPrintDocument™ の印刷プレビュー機能の使用方法を説明します。このトピックでは具体的な例として、WinGanttViewPrintDocument™ と WinPrintPreviewDialog™ を使用して WinGanttView™ コントロールの印刷プレビューを行います。

WinGanttViewPrintDocument™ コンポーネントの凡例機能をご紹介します。