PrintPreviewDialog 控件概述（Windows 窗体）

Windows 窗体 PrintPreviewDialog 控件是预先配置的对话框，用于显示 PrintDocument 在打印时的外观。可在基于 Windows
的应用程序中使用它作为简单的解决方案，而不用配置自己的对话框。该控件包含打印、放大、显示一页或多页和关闭此对话框的按钮。

主要属性和方法

该控件的主要属性是 Document，用于设置要预览的文档。文档必须是 PrintDocument 对象。若要显示此对话框，必须调用它的 ShowDialog
方法。消除锯齿可使文字显得更齐整平滑，但也会使显示更慢；若要使用它，请将 UseAntiAlias 属性设置为 true。

有些属性可通过 PrintPreviewDialog 包含的 PrintPreviewControl 获得。（不必向窗体添加此 PrintPreviewControl，向窗体添加
PrintPreviewDialog 对话框时它自动包含在此对话框中。）可通过 PrintPreviewControl 使用的属性示例是 Columns
和 Rows 属性，它们确定在控件上水平和垂直显示的页的数目。您可以像访问 Visual Basic 中的 PrintPreviewDialog1.PrintPreviewControl.Columns、Visual
C# 中的 printPreviewDialog1.PrintPreviewControl.Columns 和 Visual C++ 中的 printPreviewDialog1->PrintPreviewControl->Columns
一样访问 Columns 属性。

用户可以使用 PrintPreviewDialog
控件显示文档，通常是在打印前显示文档。

需要指定 PrintDocument
类的一个实例；这是要打印的文档。有关使用 PrintDocument 组件进行打印的更多信息，请参见如何：创建标准的 Windows
窗体打印作业。

注意
要在运行时使用 PrintPreviewDialog 控件，用户必须在计算机上安装打印机（本地安装或通过网络安装），因为这是 PrintPreviewDialog 组件确定打印时文档显示方式的一种方法。

PrintPreviewDialog 控件使用 PrinterSettings
类。此外，与 PrintPreviewDialog 组件一样，PrintPreviewDialog 控件也使用 PageSettings
类。在 PrintPreviewDialog 控件的 Document
属性中指定的打印文档引用 PrinterSettings 和 PageSettings 类的实例，而这些实例用于在预览窗口中呈现文档。

使用 PrintPreviewDialog 控件查看页

• 可使用 ShowDialog 方法显示对话框，指定要使用的
  PrintDocument。

  在下面的代码示例中，Button
  控件的 Click
  事件处理程序打开 PrintPreviewDialog 控件的实例。打印文档是在 Document
  属性中指定的。在下面的示例中，未指定任何打印文档。

  该示例要求窗体具有一个 Button 控件、一个名为 myDocument 的 PrintDocument
  组件以及一个 PrintPreviewDialog 控件。

  Private Sub Button1_Click(ByVal sender As System.Object, _
     ByVal e As System.EventArgs) Handles Button1.Click
     ' The print document 'myDocument' used below
     ' is merely for an example.
     ' You will have to specify your own print document.
     PrintPreviewDialog1.Document = myDocument
     PrintPreviewDialog1.ShowDialog()
  End Sub