PrintDialog 控件用于选择打印机、选择要打印的页以及确定其他与打印相关的设置。通过 PrintDialog 控件可以选择全部打印、打印选定的页范围或打印选定内容。
PrintDialog 控件的常用属性及说明如表1 所示。.
表1 PrintDialog 控件的常用属性及说明
注意
PrintDialog 类与 System.Windows.Forms.PrintDialog 不同,后者用于 Windows 窗体应用程序。
下面对这几种常见的属性进行详细介绍。
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。
例1:创建一个 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();
}