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

グリッドデータのレポートがどのように印刷されるかを示すプレビューの作成を開始します。

シンタックス

Visual Basic

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

C#

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

パラメータ

layout

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

printDocument

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

retainRowPropertyCategories

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

解説

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

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

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

使用例

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