Print(UltraGridLayout,PrintDocument,RowPropertyCategories) メソッド

グリッドデータの印刷レポートの作成を開始します。

シンタックス

Visual Basic

'宣言
 
Public Overloads Sub Print( _
   ByVal layout As UltraGridLayout, _
   ByVal printDocument As PrintDocument, _
   ByVal retainRowPropertyCategories As RowPropertyCategories _
) 

C#

public void Print( 
   UltraGridLayout layout,
   PrintDocument printDocument,
   RowPropertyCategories retainRowPropertyCategories
)

パラメータ

layout

オプションのレイアウトオブジェクト

printDocument

オプションの印刷ドキュメント

retainRowPropertyCategories

行の設定カテゴリを指定して、グリッドに印刷される行に適用します。

解説

Print メソッドは印刷ジョブを開始します。このメソッドをトリガーするとグリッドのデータに基づく印刷されたレポートを準備してプリンタに送信するプロセスを開始します。このプロセスには複数のステップがあり、コントロール内で印刷固有のオブジェクトとイベントの間のやりとりがあります。

このメソッドを起動する場合、印刷時にグリッド データの書式を制御する Layout オブジェクトを指定します。Layout オブジェクトによって、印刷ページにフォント、色、データの整列などの異なる属性を適用することによって、グリッドのデータに基づいてカスタム フォーマットされたレポートを作成することができます。

印刷ジョブが開始すると、InitializePrint イベントが発生します。このイベントは、印刷ジョブについての情報を含む PrintDocument オブジェクトを受け取ります。このオブジェクトのプロパティを検証および変更して、ユーザーへのフィードバックを提供し、印刷様式を制御します。Print メソッドのパラメーターとして指定した PrintDocument オブジェクトに適用した設定は、InitializePrint メソッドに表示される PrintDocument と共に渡されます。レポートを印刷する前に、Print または Print Setup ダイアログを表示するなどの動作を指定するために、これを行うことができます。

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

    Private Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click
        ' Pass in All to specify that all settings get carried over from grid rows
        ' to the print/print-preview rows. This is used to facilitate WYSIWYG printing.
        Me.UltraGrid1.PrintPreview(RowPropertyCategories.All)

        ' Call print to actually print.
        Me.UltraGrid1.Print(RowPropertyCategories.All)
    End Sub

C#

using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

		private void button1_Click(object sender, System.EventArgs e)
		{
			// Pass in All to specify that all settings get carried over from grid rows
			// to the print/print-preview rows. This is used to facilitate WYSIWYG printing.
			this.ultraGrid1.PrintPreview( RowPropertyCategories.All );
			
			// Call print to actually print.
			this.ultraGrid1.Print( RowPropertyCategories.All );
		}