c#教程之打印和打印预览

时间:2022-06-01 16:57:26

标签:

4.1      打印和打印预览

打印和打印预览是一个编辑器必须具有的功能,本节介绍实现打印和打印预览的方法。一般要实现如下菜单项:打印、打印预览、页面设置。

4.8.1PrintDocument类

PrintDocument组件是用于完成打印的类,其常用属性、方法和事件如下:
l  属性DocumentName:字符串类型,记录打印文档时显示的文档名(例如,在打印状态对话框或打印机队列中显示)。
l  方法Print:开始文档的打印。
l  事件BeginPrint:在调用Print方法后,在打印文档的第一页之前发生。
l  事件PrintPage:需要打印新的一页时发生。
l  事件EndPrint:在文档的最后一页打印后发生。
若要打印,首先创建PrintDocument组件的对象。然后使用页面设置对话框PageSetupDialog设置页面打印方式,这些设置作为要打印的所有页的默认设置。使用打印对话框PrintDialog设置对文档进行打印的打印机的参数。在打开两个对话框前,首先设置对话框的属性Document为指定的PrintDocument类对象,修改的设置将保存到PrintDocument组件对象中。第三步是调用PrintDocument.Print方法来实际打印文档。当调用该方法后,引发下列事件:BeginPrint、PrintPage、EndPrint。其中每打印一页都引发PrintPage事件,打印多页,要多次引发PrintPage事件。完成一次打印,可以引发一个或多个PrintPage事件。
程序员应为这3个事件编写事件处理函数。BeginPrint事件处理函数进行打印初始化,一般设置在打印时所有页的相同属性或共用的资源,例如所有页共同使用的字体、建立要打印的文件流等。PrintPage事件处理函数负责打印一页数据。EndPrint事件处理函数进行打印善后工作。这些处理函数的第2个参数System.Drawing.Printing.PrintEventArgs e提供了一些附加信息,主要有:
l e.Cancel:布尔变量,设置为true,将取消这次打印作业。
l e.Graphics:所使用的打印机的设备环境,参见第五章。
l e.HasMorePages:布尔变量。PrintPage事件处理函数打印一页后,仍有数据未打印,退出事件处理函数前设置HasMorePages=true,退出PrintPage事件处理函数后,将再次引发PrintPage事件,打印下一页。
l e.MarginBounds:打印区域的大小,是Rectangle结构,元素包括左上角坐标:Left和Top,宽和高:Width和Height。单位为1/100英寸。
l e.MarginBounds:打印纸的大小,是Rectangle结构。单位为1/100英寸。
l e.PageSettings:PageSettings类对象,包含用对话框PageSetupDialog设置的页面打印方式的全部信息。可用帮助查看PageSettings类的属性。
下边为这3个事件编写事件处理函数,具体步骤如下:
(1)    在最后一个using语句之后增加语句:
using System.IO;
using System.Drawing.Printing;
(2)    本例打印或预览RichTextBox中的内容,增加变量:StringReader streamToPrint=null。如果打印或预览文件,改为:StreamReader streamToPrint,流的概念参见第六章。增加打印使用的字体的变量:Font printFont。
(3)    放PrintDocument控件到窗体,属性name为printDocument1。
(4)    为printDocument1增加BeginPrint事件处理函数如下:
private void printDocument1_BeginPrint(object sender,
System.Drawing.Printing.PrintEventArgs e)
{   printFont=richTextBox1.Font;//打印使用的字体
streamToPrint=new StringReader(richTextBox1.Text);//打印richTextBox1.Text
}//如预览文件改为:streamToPrint=new StreamReader("文件的路径及文件名");
(5)    printDocument1的PrintPage事件处理函数如下。streamToPrint.ReadLine()读入一段数据,可能打印多行。本事件处理函数将此段数据打印在一行上,因此方法必须改进。
private void printDocument1_PrintPage(object sender,
System.Drawing.Printing.PrintPageEventArgs e)
{   float linesPerPage=0;//记录每页最大行数
    float yPos=0;//记录将要打印的一行数据在垂直方向的位置
    int count=0;//记录每页已打印行数
    float leftMargin=e.MarginBounds.Left;//左边距
    float topMargin=e.MarginBounds.Top;//顶边距
    string line=null;//从RichTextBox中读取一段字符将存到line中
    //每页最大行数=一页纸打印区域的高度/一行字符的高度
    linesPerPage=e.MarginBounds.Height/printFont.GetHeight(e.Graphics);
    //如果当前页已打印行数小于每页最大行数而且读出数据不为null,,继续打印
    while(count<linesPerPage&&((line=streamToPrint.ReadLine())!=null))
    {   //yPos为要打印的当前行在垂直方向上的位置
yPos=topMargin+(count*printFont.GetHeight(e.Graphics));
        e.Graphics.DrawString(line,printFont,Brushes.Black,
leftMargin,yPos,new StringFormat());//打印,参见第五章
        count++;//已打印行数加1
    }
    if(line!=null)//是否需要打印下一页
        e.HasMorePages=true;//需要打印下一页
    else
        e.HasMorePages=false;//不需要打印下一页
}
(6)    为printDocument1增加EndPrint事件处理函数如下:
private void printDocument1_EndPrint (object sender,
System.Drawing.Printing.PrintEventArgs e)
{   if(streamToPrint!=null)
        streamToPrint.Close();//释放不用的资源
}

4.8.2打印设置对话框控件PageSetupDialog