14-打印对话框

14.4.4　打印对话框

PrintDialog控件用于显示预先配置的对话框，用户可以使用该对话框选择打印机、要打印的页以及确定与打印有关的设置。

下表列出了PrintDialog类的常用成员及说明。

| 成员名称 | 类别 | 说明 | | :----- | :----- | :----- | :----- | :----- | | AllowPrintToFile | 属性 | 禁止或使用“打印到文件”复选框 | | AllowSelection | 属性 | 禁止或使用“选定内容”单选按钮 | | AllowSomePages | 属性 | 禁止或使用“页”单选按钮 | | Document | 属性 | 从中获取打印机设置的PrintDocument | | PrintToFile | 属性 | “打印到文件”复选框是否选中 | | ShowHelp | 属性 | 控制是否显示“帮助”按钮 | | ShowDialog | 方法 | 显示打印对话框 |

下面对比较重要的两个成员进行介绍。

（1）Document属性。用于获取或设置一个值，指示用于获取PrintDocument对象。默认值为空引用。

（2）ShowDialog方法。用来显示与打印机相关设置的对话框。该方法常与Document属性一起使用。如果用户在对话框中单击【确定】按钮，返回值则为DialogResult.OK，否则返回值为DialogResult.Cancel。

下面演示如何创建PrintDialog组件的实例，并设置其属性。代码如下。

01  this.printDialog1.AllowCurrentPage = true;   //显示当前页
02  this.printDialog1.AllowPrintToFile = true;   //允许选择打印到文件
03  this.printDialog1.AllowSelection = true;
04  this.printDialog1.AllowSomePages = true;
05  this.printDialog1.PrintToFile = false;       //不选择“打印到文件”
06  this.printDialog1.ShowHelp = true;
07  this.printDialog1.ShowNetwork = true;        //可以选择网络打印机
08  this.printDialog1.ShowDialog();