C# Windows打印控件之 PrintDialog 控件

PrintDialog 控件用于选择打印机、选择要打印的页以及确定其他与打印相关的设置。通过 PrintDialog 控件可以选择全部打印、打印选定的页范围或打印选定内容。

PrintDialog 控件的常用属性及说明如表1 所示。.

C# Windows打印控件之 PrintDialog 控件

        表1  PrintDialog 控件的常用属性及说明

注意

PrintDialog 类与 System.Windows.Forms.PrintDialog 不同,后者用于 Windows 窗体应用程序。

下面对这几种常见的属性进行详细介绍。

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();}