PrintDialog控件
PrintDialog控件用于选择打印机、选择要打印的页以及确定其他与打印相关的设置。通过PrintDialog控件可以选择全部打印、打印选定的页范围或打印选定内容。PrintDialog控件的常见属性及说明如表1所示。
表1 PrintDialog控件的常用属性及说明
属性 |
说明 |
Document |
获取PrinterSettings类的PrintDocument对象 |
AllowCurrentPage |
是否显示“当前页”选项按钮 |
AllowPrintToFile |
是否启用“打印到文件”复选框 |
AllowSelection |
是否启用“选择”选项按钮 |
AllowSomePages |
是否启用“页”选项按钮 |
下面对这几种常见的属性进行详细的介绍。
(1)Document属性
用于获取PrinterSettings的PrintDocument。
语法:
public PrintDocument Document { get; set; }
属性值:PrinterSettings的PrintDocument。
(2)AllowCurrentPage属性
用于设置是否显示“当前页”选项按钮。
语法:
public bool AllowCurrentPage { get; set; }
属性值:如果显示“当前页”选项按钮,为true;否则为false。默认为false。
(3)AllowPrintToFile属性
用于设置是否启用“打印到文件”复选框。
语法:
public bool AllowPrintToFile { get; set; }
属性值:如果启用“打印到文件”复选框,为true;否则为false。默认为true。
(4)AllowSelection属性
用于设置是否启用“选择”选项按钮。
语法:
public bool AllowSelection { get; set; }
属性值:如果启用“选择”选项按钮,为true;否则为false。默认为false。
(5)AllowSomePages属性
用于设置是否启用“页”选项按钮。
语法:
public bool AllowSomePages { get; set; }
属性值:如果启用“页”选项按钮,为true;否则为false。默认为false。
例 创建一个Windows应用程序,向窗体中添加一个PrintDialog控件、一个PrintDocument控件和一个Button控件。在Button控件的Click事件中设置PrintDialog控件的相应属性,最后打开“打印”设置窗体,代码如下。
private void button1_Click(object sender, EventArgs e) { //设置printDialog控件的Document属性,设置操作文档 printDialog1.Document = printDocument1; //启用"打印到文件"复选框 printDialog1.AllowPrintToFile = true; //显示“当前项”按钮 printDialog1.AllowCurrentPage = true; //启用"选择按钮" printDialog1.AllowSelection = true; //启用"页"按钮 printDialog1.AllowSomePages = true; printDialog1.ShowDialog(); }
运行程序,单击“打印机设置”按钮,如图所示。