'宣言 Public Class UltraPrintPreviewControl Inherits UltraPrintPreviewControlBase Implements Infragistics.Win.AppStyling.ISupportAppStyling, Infragistics.Win.IUltraControl, Infragistics.Win.IUltraControlElement, Infragistics.Win.Touch.ISupportTouchMetrics, Infragistics.Win.UIAutomation.IProvideUIAutomation
public class UltraPrintPreviewControl : UltraPrintPreviewControlBase, Infragistics.Win.AppStyling.ISupportAppStyling, Infragistics.Win.IUltraControl, Infragistics.Win.IUltraControlElement, Infragistics.Win.Touch.ISupportTouchMetrics, Infragistics.Win.UIAutomation.IProvideUIAutomation
UltraPrintPreviewControl は、印刷プレビュー ページを生成および表示するために使用される特化した UltraPrintPreviewControlBase です。コントロールは、UltraPrintPreviewThumbnail と関連して使用されますが、UltraPrintPreviewThumbnail.PreviewControl を介して UltraPrintPreviewControl と関連づけられた場合、プレビュー コントロールに表示されるページを変更するために使用できます。
Document プロパティは、どの System.Drawing.Printing.PrintDocument がプレビュー ページを提供するのかを指定するために使用されます。AutoGeneratePreview プロパティを使用してこれを防止できますが通常コントロールがいったん描画されると、デフォルトでは、ページが当初要求されるとプレビュー ページが生成されます。プレビュー操作が実行中に、印刷されるページ番号を示すステータス ダイアログが表示します。このダイアログには印刷操作をキャンセルするために使用できるキャンセル ボタンがあります。DisplayPreviewStatus プロパティを使用してダイアログを表示しないようにできます。印刷操作が完了すると PreviewGenerated イベントが呼び出されます。
UltraPrintPreviewControl には、マウスを使用して、ズームを変更する、特定の領域でズームインする、ページの一部のスナップショットをクリップボードに配置する、または MouseAction プロパティに基づいてスクロールする機能も含まれます。
コントロールには表示履歴のサポートも含まれます。表示履歴はさまざまな点のスクロールの位置とズーム設定のスナップショットです。これらのスナップショットは、エンドユーザーがスクロール、ズームを変更、関連付けられた UltraPrintPreviewThumbnail コントロールの表示ボックスをドラッグすると、自動的に取得されます。表示履歴が変更すると、ViewHistoryChanged イベントが呼び出されます。HasNextView プロパティと HasPreviousView プロパティは、エンドユーザーが表示履歴の前の項目または次の項目にナビゲートするかどうかを決定するために使用できます。PerformAction メソッドは、表示履歴を前後にナビゲートする (それぞれ PreviousView および NextView のアクションを使用) 、または表示履歴をクリアする (ClearViewHistory のアクションを使用) ために使用できます。