學習.Net(c#)列印–列印結構

   System.Drawing.Printing;命名空間中的類可以幫助在應用程式中列印文檔。
    列印的基類是PrintDocument，方法Print()會啟動一系列調用，最後調用OnPrintPage(),把輸出結果傳送給列印機。

列印結構：
    下圖顯示了列印結構的主要部分
   

說明：
    PrintDocument：　是最重要的類。幾乎所有的列印類都與這個類有關係。要列印一個文檔，需要PrintDocument的一個實例。
    PrintController：　類控製列印任務流。提供了列印開始、列印每個頁面和列印結束的事件。派生於PrintController的具體類有StandardPrintController和PreviewPrintController。
    PrintSettings：　類可以獲取列印和設置列印機配置。這個類配置由PageSetupDialog類進行。
    PrintDialog：　　類確定使用哪個列印機進行列印和如何配置PrinterSettings。
    Graphics：　　　可以訪問列印機的設備內容，給列印機發送字串、線條和曲線。
    PageSetupDialog：設置列印頁面。
      PrintPreviewDialg：列印預覽頁面。

其中：

   PrintDialog頁面樣式如下圖：
   

 

    PrintSetupDialog頁面格式如下圖：

   

 

PrintPreviewDialog頁面樣式如下圖：

   

 

列印流程：
    以下圖為例：
   

    應用程式必須調用PrintDocument的Print()方法，啟動調用序列。因為PrintDocument本身並不負責列印流，所以由PrintController通過調用這個類的Print()方法完成列印。    列印控制器現在執行操作，通知PrintDocument，通過調用OnBeginPrint()開始列印。如果應用程式在列印任務的開始執行某些操作，就必須在PrintDocument中註冊一個事件處理程式，這樣才會在應用程式類中接到通知。如上圖中，假定註冊了處理程式OnBeginPrint(),所以這個處理程式應在PrintDocument類中調用。
  在開始階段完成後，PrintController就進入PrintLoop(),為每個要列印的頁面調用PrintDocument類中的OnPrintPage()方法。OnPrintPage()調用所有的PrintPage事件處理程式。必須對每個頁面執行這個處理程式，否則就不會列印任何內容。
    可以在PrintDocument.PrintPage處理程式中執行列印代碼。每個列印頁面都要調用該處理程式。如果列印任務只需要執行一次列印代碼，就必須執行BeginPrint和Endprint事件和處理程式。
   在列印完成最後一頁後，PrintController就調用PrintDocument類中的OnEndPrint()。也可以執行要在這裡調用的處理程式。

如何列印（簡單列印方法）？

    要實現列印必須有如下內容：
        1、列印檔案檔，用於列印機印機。此用PrintDocument類實例化
        2、被列印的內容。處理用PintDocument中PrintPage事件方法得到被列印內容。

    其方法如下：
       1、實例化PrintDocument類。聲明需要列印的文檔
        2、增加PrintDocument.PrintPage事件，此事件的方法用於得到被列印的內容
        3、調用PrintDocument.Print()方法列印內容，在列印之前，此方法會在PrntController類的幫助下先呼叫PrintPage事件的方法
        4、在PrintPage事件中繪製列印文本，用於得到列印內容，此方法結束後會回到PrintDocument.Print()方法中，執行列印

代碼如下：
    註：介面中一個多行的TextBox： textBoxEdit
        和一個列印菜單：MiFilePrint

using System.IO;
using System.Drawing.Printing;

namespace SimpleEditor
{
    public partial class SimpleEditorForm : Form
    {
        /*
        窗體中一個列印菜單:名稱為:MiFilePrint
        一個多行TextBoxG：名稱為：textBoxEdit
        */
      
        //1、 實例化PrintDocument類
        PrintDocument pdDocument = new PrintDocument();

        public SimpleEditorForm()
        {
            InitializeComponent();
            //2、 訂閱PrintDocument.PrintPage事件
            pdDocument.PrintPage += new PrintPageEventHandler(OnPrintPage);
        }

        
       /// <summary>
        /// 當按下列印時，此為介面中的列印按鈕事件
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>

        private void OnFilePrint(object sender, EventArgs e)
        {
            try
            {
                /*
                * PrintDocument對象的Print()方法在PrintController類的幫助下，執行PrintPage事件。
                */

                //3、調用PrintDocument.Print()方法
                pdDocument.Print();                
        
            }
            catch (InvalidPrinterException ex )
            {
                MessageBox.Show(ex.Message, "Simple Editor", MessageBoxButtons.OK, MessageBoxIcon.Error);
                throw;
            }
        }
        

        /// <summary>
        /// printDocument的PrintPage事件
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void OnPrintPage(object sender, PrintPageEventArgs e)
        {
            /*
             * 得到TextBox中每行的字串數組
             * \n換行
             * \r回車
             */
            char[] param ={'\n'};
            string[] lines = textBoxEdit.Text.Split(param);

            int i = 0;
            char[] trimParam ={'\r'};
            foreach (string s in lines)
            {
                //刪除每行中的\r
                lines[i++] = s.TrimEnd(trimParam);
            }

            int x = 20;
            int y = 20;
            foreach (string line in lines)
            {
                /*
                 * 4、把文本行發送給列印機，其中e是PrintPageEventArgs類型的一個變量，其屬性連接到列印機關聯文本中。
                 * 列印機關聯文本可以寫到列印機設備上。
                 * 輸出結果的位置用變更X和Y定義。
                 */
                e.Graphics.DrawString(line, new Font("Arial", 10), Brushes.Black, x, y);
                y += 15;
            }
        }
    }
}

這樣就學習了簡單的列印功能。

雖然我們實現了打功能，可是你在列印時會發現，當列印內容超過一頁時，我們如何實現多頁列印呢？
請看下頁：學習.Net(c#)列印--多頁列印