InitializePrintPreview イベント

PrintPreviewメソッドの呼び出しによって印刷プレビューがはじめて開始されるときに発生します。

シンタックス

Visual Basic

'宣言
 
Public Event InitializePrintPreview As InitializePrintPreviewEventHandler

C#

public event InitializePrintPreviewEventHandler InitializePrintPreview

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、CancelablePrintPreviewEventArgs 型の引数を受け取りました。次の CancelablePrintPreviewEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
Cancel System.ComponentModel.CancelEventArgsから継承されます。
DefaultLogicalPageLayoutInfo Infragistics.Win.UltraWinGrid.CancelablePrintEventArgsから継承されます。	すべての論理ページのデフォルトのレイアウト情報を返します。
PrintDocument Infragistics.Win.UltraWinGrid.CancelablePrintEventArgsから継承されます。	印刷ドキュメントを返します。
PrintLayout Infragistics.Win.UltraWinGrid.CancelablePrintEventArgsから継承されます。	印刷レイアウトを返します。
PrintPreviewSettings	印刷プレビューのダイアログボックスの設定を返します。

解説

PrintPreview メソッドから印刷ジョブが最初に開始される場合に、InitializePrintPreview イベントが発生します。印刷プレビュー (ズーム、プレビュー ウィンドウ タイトルおよびアイコン) のデフォルト パラメーターを設定し、プレビューされるデータにデフォルトの印刷ジョブ設定 (ページ ヘッダー、ページ フッター、マージンなど) を適用する機会をユーザーに与えます。これらの設定を適用するために printinfo パラメーターを介してイベントに渡される PrintInfo オブジェクトを使用します。

InitializePrintPreview イベントでデフォルトの印刷設定を設定後、印刷プレビュー画面がエンドユーザーに表示され、指定した設定を使用して印刷ジョブをプレビューします。ユーザーはレポートの異なる部分を表示したり、提供されるインターフェイスと直接対応することで印刷ジョブの設定を変更することができます。プレビュー画面から直接印刷を選択することもできます。これによって InitializePrint イベントがトリガーします。どのように PrintPreview メソッドがトリガーするかによって、印刷ダイアログも表示されます。

PrintInfo オブジェクトは、BeforePrint イベント、InitializePrint イベントおよび InitializeLogicalPrintPage イベント中に限ってアクセス可能です。

使用例

Visual Basic

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

  Private Sub UltraGrid1_InitializePrintPreview(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.CancelablePrintPreviewEventArgs) Handles ultraGrid1.InitializePrintPreview

      ' Set the zomm level to 100 % in the print preview.
      e.PrintPreviewSettings.Zoom = 1.0

      ' Set the location and size of the print preview dialog.
      e.PrintPreviewSettings.DialogLeft = SystemInformation.WorkingArea.X
      e.PrintPreviewSettings.DialogTop = SystemInformation.WorkingArea.Y
      e.PrintPreviewSettings.DialogWidth = SystemInformation.WorkingArea.Width
      e.PrintPreviewSettings.DialogHeight = SystemInformation.WorkingArea.Height

      ' Horizontally fit everything in a signle page.
      e.DefaultLogicalPageLayoutInfo.FitWidthToPages = 1

      ' Set up the header and the footer.
      e.DefaultLogicalPageLayoutInfo.PageHeader = "Title"
      e.DefaultLogicalPageLayoutInfo.PageHeaderHeight = 40
      e.DefaultLogicalPageLayoutInfo.PageHeaderAppearance.FontData.SizeInPoints = 14
      e.DefaultLogicalPageLayoutInfo.PageHeaderAppearance.TextHAlign = HAlign.Center
      e.DefaultLogicalPageLayoutInfo.PageHeaderBorderStyle = UIElementBorderStyle.Solid

      ' Use <#> token in the string to designate page numbers.
      e.DefaultLogicalPageLayoutInfo.PageFooter = "Page <#>."
      e.DefaultLogicalPageLayoutInfo.PageFooterHeight = 40
      e.DefaultLogicalPageLayoutInfo.PageFooterAppearance.TextHAlign = HAlign.Right
      e.DefaultLogicalPageLayoutInfo.PageFooterAppearance.FontData.Italic = DefaultableBoolean.True
      e.DefaultLogicalPageLayoutInfo.PageFooterBorderStyle = UIElementBorderStyle.Solid

      ' Set the ClippingOverride to Yes.
      e.DefaultLogicalPageLayoutInfo.ClippingOverride = ClippingOverride.Yes

      ' Set the document name through the PrintDocument which returns a PrintDocument object.
      e.PrintDocument.DocumentName = "Document Name"

  End Sub

C#

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

private void ultraGrid1_InitializePrintPreview(object sender, Infragistics.Win.UltraWinGrid.CancelablePrintPreviewEventArgs e)
{

	// Set the zomm level to 100 % in the print preview.
	e.PrintPreviewSettings.Zoom = 1.0;

	// Set the location and size of the print preview dialog.
	e.PrintPreviewSettings.DialogLeft = SystemInformation.WorkingArea.X;
	e.PrintPreviewSettings.DialogTop = SystemInformation.WorkingArea.Y;
	e.PrintPreviewSettings.DialogWidth = SystemInformation.WorkingArea.Width;
	e.PrintPreviewSettings.DialogHeight  = SystemInformation.WorkingArea.Height;

	// Horizontally fit everything in a signle page.
	e.DefaultLogicalPageLayoutInfo.FitWidthToPages = 1;

	// Set up the header and the footer.
	e.DefaultLogicalPageLayoutInfo.PageHeader = "Title";
	e.DefaultLogicalPageLayoutInfo.PageHeaderHeight = 40;
	e.DefaultLogicalPageLayoutInfo.PageHeaderAppearance.FontData.SizeInPoints = 14;
	e.DefaultLogicalPageLayoutInfo.PageHeaderAppearance.TextHAlign = HAlign.Center;
	e.DefaultLogicalPageLayoutInfo.PageHeaderBorderStyle = UIElementBorderStyle.Solid;
	
	// Use <#> token in the string to designate page numbers.
	e.DefaultLogicalPageLayoutInfo.PageFooter = "Page <#>.";
	e.DefaultLogicalPageLayoutInfo.PageFooterHeight= 40;
	e.DefaultLogicalPageLayoutInfo.PageFooterAppearance.TextHAlign = HAlign.Right;
	e.DefaultLogicalPageLayoutInfo.PageFooterAppearance.FontData.Italic = DefaultableBoolean.True;
	e.DefaultLogicalPageLayoutInfo.PageFooterBorderStyle = UIElementBorderStyle.Solid;

	// Set the ClippingOverride to Yes.
	e.DefaultLogicalPageLayoutInfo.ClippingOverride = ClippingOverride.Yes;

	// Set the document name through the PrintDocument which returns a PrintDocument object.
	e.PrintDocument.DocumentName = "Document Name";

}