1. 程式人生 > >C#實現列印與列印預覽功能

C#實現列印與列印預覽功能

在windows應用程式中文件的列印是一項非常重要的功能,在以前一直是一個非常複雜的工作,Microsoft .Net Framework的列印功能都以元件的方式提供,為程式設計師提供了很大的方便,但是這幾個元件的使用還是很複雜的,有必要解釋一下。 
列印操作通常包括以下四個功能: 
1 列印設定 設定印表機的一些引數,比如更改印表機驅動程式等; 
2 頁面設定 設定頁面大小紙張型別等 
3 列印預覽 類似於word中的列印預覽 
4 列印

實現列印功能的核心是PrintDocument類這個類屬於System.Drawing.Printing名字空間這個類封裝了當前的列印設定頁面設定以及所有的與列印有關的事件和方法 
這個類包括以下幾個屬性,事件和方法 
1、PrinterSettings 屬性 
  存放印表機的設定資訊,這個屬性不需要程式設計師設定,因為它是由列印對話方塊獲取的. 
2、PrintCountroller 屬性 
  控制列印過程 
3、DefaultPageSettings 屬性 
  存放頁面設定資訊,列印紙大小方向等,也不需要程式設計師設定,因為它是由頁面設定對話方塊獲取的. 
4、DocumentName 屬性 
  指定文件名稱,出現在印表機狀態視窗中 

1。 BeginPrint事件 
  在列印之前發出 
2. PrintPage事件 
  每列印一頁是發出,事件接受一個PrintPageEventArgs引數該引數封裝了列印相關的資訊

PrintPageEventArgs引數有很多重要的屬性 
  1 Cancel 取消列印 
  2 Graphics 頁面的繪圖物件 
  3 HasMorePages 是否還有要列印的頁面


Print方法:該方法沒有引數 呼叫它將按照當前設定開始列印. 
若實現列印功能首先構造PrintDocument物件新增列印事件 

   1: PrintDocument printDocument;
   2:
private void InitializeComponent()
   3: {
   4:     ...
   5:  // 這裡的printDocument物件可以通過將PrintDocument控制元件拖放到窗體上來實現,注意要設定該控制元件的PrintPage事件。
   6:     printDocument=new PrintDocument();
   7:     printDocument.PrintPage += new PrintPageEventHandler (this.printDocument_PrintPage);
   8: ...
   9: }


實現列印事件功能

 
列印和繪圖類似都是呼叫Graphics 類的方法進行畫圖 不同的是一個在顯示器上一個在列印紙上並且列印要進行一些複雜的計算 
如換行、分頁等。 

   1: private void printDocument_PrintPage(object sender,PrintPageEventArgs e)
   2: {
   3:     Graphics g = e.Graphics; //獲得繪圖物件
   4:     float linesPerPage = 0; //頁面的行號
   5:     float yPosition = 0;   //繪製字串的縱向位置
   6:     int count = 0; //行計數器
   7:     float leftMargin = e.MarginBounds.Left; //左邊距
   8:     float topMargin = e.MarginBounds.Top; //上邊距
   9:     string line = null; 行字串
  10:     Font printFont = this.textBox.Font; //當前的列印字型
  11:     SolidBrush myBrush = new SolidBrush(Color.Black);//刷子
  12:     linesPerPage = e.MarginBounds.Height / printFont.GetHeight(g);//每頁可列印的行數
  13:  //逐行的迴圈列印一頁
  14:     while(count < linesPerPage && ((line=lineReader.ReadLine()) != null))
  15:     {
  16:        yPosition = topMargin + (count * printFont.GetHeight(g));
  17:        g.DrawString(line, printFont, myBrush, leftMargin, yPosition, new StringFormat());
  18:        count++;
  19:     }
  20:  // 注意:使用本段程式碼前,要在該窗體的類中定義lineReader物件:
  21:  //       StringReader lineReader = null;
  22:     //如果本頁列印完成而line不為空,說明還有沒完成的頁面,這將觸發下一次的列印事件。在下一次的列印中lineReader會
  23:     //自動讀取上次沒有列印完的內容,因為lineReader是這個列印方法外的類的成員,它可以記錄當前讀取的位置
  24:     if(line != null)
  25:         e.HasMorePages = true;
  26:     else
  27:  {
  28:         e.HasMorePages = false;
  29:   // 重新初始化lineReader物件,不然使用列印預覽中的列印按鈕打印出來是空白頁
  30:   lineReader = new StringReader(textBox.Text); // textBox是你要列印的文字框的內容
  31:  }
  32: }


列印設定,構造列印對話方塊 將對話方塊中設定的Document屬性賦給printDocument這樣會將使用者的設定自動儲存到printDocument 
的PrinterSettings屬性中 

   1: protected  void FileMenuItem_PrintSet_Click(object sender,EventArgs e)
   2: {
   3:     PrintDialog printDialog = new PrintDialog();
   4:     printDialog.Document = printDocument;
   5:     printDialog.ShowDialog();
   6: }


頁面設定和列印預覽與列印設定原理相同都是構造對話方塊將使用者在對話方塊中的設定儲存到相應的類的屬性中 

   1: protected  void FileMenuItem_PageSet_Click(object sender,EventArgs e)
   2: {
   3:     PageSetupDialog pageSetupDialog = new PageSetupDialog();
   4:     pageSetupDialog.Document = printDocument;
   5:     pageSetupDialog.ShowDialog();
   6: }


列印預覽 

   1: protected void FileMenuItem_PrintView_Click(object sender,EventArgs e)
   2: {
   3:    PrintPreviewDialog printPreviewDialog = new PrintPreviewDialog();
   4:    printPreviewDialog.Document = printDocument;
   5:    lineReader = new StringReader(textBox.Text);
   6:    try
   7:    {
   8:         printPreviewDialog.ShowDialog();
   9:    }
  10:    catch(Exception excep)
  11:    {
  12:         MessageBox.Show(excep.Message, "打印出錯", MessageBoxButtons.OK, MessageBoxIcon.Error);
  13:    }
  14: }


列印就可以直接呼叫printDocument的Print()方法因為使用者可能在列印之前還要再更改列印設定所以 
在這裡再次顯示列印設定對話方塊 

   1: protected void FileMenuItem_Print_Click(object sender,EventArgs e)
   2:  {
   3:   PrintDialog printDialog = new PrintDialog();
   4:   printDialog.Document = printDocument;
   5:   lineReader = new StringReader(textBox.Text);
   6:   if (printDialog.ShowDialog() == DialogResult.OK)
   7:   {
   8:       try
   9:       {
  10:         printDocument.Print();
  11:       }
  12:       catch(Exception excep)
  13:       {
  14:              MessageBox.Show(excep.Message, "打印出錯", MessageBoxButtons.OK, MessageBoxIcon.Error);
  15:              printDocument.PrintController.OnEndPrint(printDocument,new PrintEventArgs());
  16:       }
  17:    }
  18:  }
 

總結列印的過程是 
1 在應用程式窗體初始化時構造PrintDocument物件,新增 printDocument 的 PrintPage 方法 
2 實現PrintPage方法 
3 在使用者的單擊事件中呼叫 printDocument 的 Print方法實現列印功能 
在這中間可能要用到  PrintDialog PrintPreviewDialog PageSetupDialog 設定和檢視列印效果這些方法通常是由選單的單擊觸發的。