1. 程式人生 > >吉特倉庫管理系統-.NET列印問題總結

吉特倉庫管理系統-.NET列印問題總結

  在倉儲系統的是使用過程中避免不了的是列印單據,倉庫系統中包含很多單據:入庫單,出庫單,盤點單,調撥單,簽收單等等,而且還附帶著很多的條碼標籤的列印。本文在此記錄一下一個簡單的列印問題處理方式。處理問題環境如下:

在做標籤列印的時候,同事說要使用OPOS指令來列印小單據標籤,但是後面送過來的印表機卻是斑馬印表機,不支援OPOS指令列印,於是很無奈。當時自己提出過另外一種解決方案,那就是使用第三方列印軟體,然後使用.NET來呼叫這個軟體列印,這個也是本人之前一直使用的列印方式,比較有名的第三方列印軟體bartender. 但是的確這個實施不方便。於是自己使用了最原始用.NET PrintDocument 來列印輸出。

  一. 列印需求

    1. 能夠列印Logo,也就是列印圖片

    2. 列印固定文字,並且能夠控制文字大小

    3. 列印變數資訊

    4. 列印列表資訊

    5. 列印條碼 二維碼

    6. 列印紙張大小的控制

    以上是個人總結出來做單據列印的一些常用功能,也是比較實用的一些要求,相信做過列印單據的同學應該都遇到過。 在以上幾點的需求上有幾個比較麻煩的是列印列表,相對比較複雜。對於條碼以及二維碼的列印其實就是列印圖片,使用相應的元件來生成圖片列印即可。

  二. GDI+繪圖列印

    不用多說,這個肯定是PrintDocument 列印的重點,可能一般做Web開發的同學對列印關注的較少,這裡先說WinForm 客戶端程式的列印,後續講解Web上的列印問題。在部落格園中搜索了一篇不錯的文章介紹GDI畫圖

    《GDI+繪圖》  可以查看了解一下GDI+繪圖的基本知識

    PrintDocument 文件列印類中有一個Print()列印方法,用於觸發列印,PrintPage 事件則在列印命令執行時觸發,我們可以在這個事件的方法中繪圖,用於實現要列印的內容。先看看一個簡單的案例

private void Print(object sender, System.Drawing.Printing.PrintPageEventArgs e)
        {
            int top = 5;
            int left = 4;

            Brush bru 
= Brushes.Black; Graphics g = e.Graphics; for (int i = 0; i < listResult.Count; i++) { BarCodeEntity entity = listResult[i]; if (entity != null) { int xMo = i % 4; int yMo = i / 4; int width = 90; int height = 79; g.DrawString("合格證", new Font("黑體", 8, FontStyle.Bold), bru, new PointF(left + width * xMo + 22, height * yMo + top)); g.DrawString("本產品經檢驗合格准予出廠", new Font("黑體", 4.7f, FontStyle.Bold), bru, new PointF(left + width * xMo, height * yMo + 13 + top + 5)); g.DrawString("檢驗員:" + entity.Number + "號 保質期:三年", new Font("黑體", 4.7f, FontStyle.Bold), bru, new PointF(left + width * xMo, height * yMo + 26 + top + 5)); g.DrawString("生產日期:" + entity.Time, new Font("黑體", 4.7f, FontStyle.Bold), bru, new PointF(left + width * xMo, height * yMo + 39 + top + 5)); float length = 7f; float fontWidth = entity.CompanyName.IsEmpty() ? 0 : length * (entity.CompanyName.Length * 1.0f); float fontSize = 4.4f; int marginLeft = 0; if (entity.CompanyName.Length > 13) { fontSize = 4.0f; } else { marginLeft = (int)((91 - fontWidth) / 2); } g.DrawString(entity.CompanyName, new Font("黑體", fontSize, FontStyle.Bold), bru, new PointF(left + width * xMo + marginLeft, height * yMo + 52 + top + 5)); } } }
列印繪圖簡單案例

     Brush bru = Brushes.Black;

     Graphics g = e.Graphics;

    以上兩個是繪圖的重點,定義了畫筆以及繪圖物件。在PrintPage事件中可以獲得繪圖物件,我們利用此物件來繪製圖片,文字,條碼,二維碼等

public void DrawImage(Image image, PointF point);

public void DrawImageUnscaled(Image image, Point point);

public void DrawLine(Pen pen, Point pt1, Point pt2);

public void DrawPie(Pen pen, Rectangle rect, float startAngle, float sweepAngle);

public void DrawRectangle(Pen pen, Rectangle rect);

public void DrawString(string s, Font font, Brush brush, RectangleF layoutRectangle);

    以上是常用的一些繪圖方法,繪製圖片,直線,圓,方框,字串等等。可以到微軟MSDN官網檢視更多的繪圖方法

    

    以上是一個簡單的列印示例,畫圖方式比較原始,但是包含了不同的文字,二維碼圖片等。

  三. PrintDocument使用的缺點

    以上程式碼打印出來,貌似效果還不錯,在小標籤紙上效果也挺漂亮.但是問題來了,有一天客戶提出需求說,我現在要換打標籤紙了,而且文字的排版方式也要稍微做修改。從上面的一段示例程式碼來看,列印無非就是輸出內容(文字,線框,圖片等). 然後就是定義響應的座標即可,也就是點陣型別的列印。將標籤紙作為一個畫布,然後計算好座標在相應的位置輸出內容即可。 如果標籤紙大小變了(排版),那麼意味著座標點也要重新計算,一下子是欲哭無淚。

    當時他們要求使用OPOS指令,ZPL指定也就是因為可以自定義模板.但是不同的印表機支援指令性質不一樣,那就只能自己定義一套模板規則來滿足要求,並且擺脫不同印表機廠商的限制。

<?xml version="1.0" encoding="utf-8" ?>
<Page Width="200" Heigth="700" DefaultPrinter="ZDesigner GK888t (EPL)">
  <Line Height="72">
    <Image Left="20" Top="30">{{Logo}}</Image>
  </Line>
  <Line Height="50">
    <Text Left="50" Top="2" FontSize="15">預定憑條</Text>
  </Line>
  <Line Height="30">
    <Text Left="15" Top="2" FontSize="16">保稅區1店</Text>
  </Line>
  <Line Height="20">
    <Text Left="70" Top="2" FontSize="8">No.150 page.1</Text>
  </Line>
  <Line Height="70">
    <QRCode Left="20" Top="2" >{{OrderCode}}</QRCode>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="10">單據號:{{OrderCode}}</Text>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="10">提貨時間:{{DtReceive}}</Text>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="10">提貨點:{{ReceiveAddress}}</Text>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="10">聯絡人:{{ReceiveUser}}</Text>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="10">聯絡電話:{{ReceiverPhone}}</Text>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="10">時間:{{DtCreate}}</Text>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="18">-------------</Text>
  </Line>
  <Line Height="30">
    <Text Left="2" Top="2" FontSize="7">序號</Text>
    <Text Left="30" Top="2" FontSize="7">貨號</Text>
    <Text Left="70" Top="2" FontSize="7">品名</Text>

    <Text Left="30" Top="17" FontSize="7">數量</Text>
    <Text Left="70" Top="17" FontSize="7">單價</Text>
    <Text Left="150" Top="17" FontSize="7">金額</Text>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="18">-------------</Text>
  </Line>

  <Loop Values="Detials">
    <Line Height="30">
      <Text Left="2" Top="2" FontSize="7">{{Index}}</Text>
      <Text Left="30" Top="2" FontSize="7">{{StrID}}</Text>
      <Text Left="70" Top="2" FontSize="7">{{StrName}}</Text>

      <Text Left="30" Top="17" FontSize="7">{{DCount}}</Text>
      <Text Left="60" Top="17" FontSize="7">*</Text>
      <Text Left="70" Top="17" FontSize="7">{{DPrice}}</Text>
      <Text Left="140" Top="17" FontSize="7">=</Text>
      <Text Left="150" Top="17" FontSize="7">{{DAmount}}</Text>
    </Line>
  </Loop>

  <Line Height="20">
    <Text Left="2" Top="2" FontSize="18">-------------</Text>
  </Line>

  <Line Height="20">
    <Text Left="2" Top="2" FontSize="7">聯機刷卡</Text>
    <Text Left="100" Top="2" FontSize="7">人民幣{{DAmount}}</Text>
  </Line>

  <Line Height="20">
    <Text Left="2" Top="2" FontSize="18">--------------</Text>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="7">商品數:{{DCount}}</Text>
    <Text Left="100" Top="2" FontSize="7">總金額:{{DAmount}}</Text>
  </Line>
  <Line Height="70">
    <BarCode Left="20" Top="2" Width="100" Height="60">{{OrderCode}}</BarCode>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="18">--------------</Text>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="7">謝謝惠顧,歡迎再次光臨</Text>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="7">提貨憑據,請妥善保管</Text>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="7">客服熱線:*******</Text>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="7"></Text>
  </Line>
  <Line Height="20">
    <Text Left="2" Top="2" FontSize="7"></Text>
  </Line>
</Page>
模板定義預覽

    為了儘快應付工作問題,在短時間倉促定義瞭如上模板,用於設定定義指令。以上模板主要內容是控制座標點以及列印內容的動態體會:

    Page標籤: 用於定義列印紙張, 屬性:Width 紙張寬度, Heigth 紙張高度, DefaultPrinter 預設使用印表機的名稱

    Line標籤: 在列印過程中預定都是以行來列印,只是列印行座標不一樣(這樣可以控制交叉的情況) 。 定義列印一行, Height 列印行的高度

    Image標籤: 用於列印圖片 Left 用於設定距離Line 左邊的距離 Top 用於設定距離Line 頂部的距離,Image 必須包含到Line標籤中。

    Text標籤:用於列印文字資訊  Left 用於設定距離Line 左邊的距離 Top 用於設定距離Line 頂部的距離,FontSize 用於設定列印字型大小, Text必須包含到Line標籤中。

    QRCode標籤:用於列印二維碼圖片, Left 用於設定距離Line 左邊的距離 Top 用於設定距離Line 頂部的距離

    BarCode標籤:用於列印條碼圖片,Left 用於設定距離Line 左邊的距離 Top 用於設定距離Line 頂部的距離.Width 設定條碼的長度,Height 設定條碼的高度

    Loop標籤:用於迴圈列印,必須包含Line標籤,也就是迴圈列印Line標籤。Values 設定資料來源的Key值

    {{}}指令:用於替換的變數佔位符

    

    畫了一個草圖理解標籤中的屬性Left,Top. Line都是以紙張橫座標為0的前提下列印的,也就是說Left是以座標X=0的情況為計算標準, 而Top 是以Line的內聚為標準,如果有多個Line 則需要先計算上層所有Line的高度總和才能定義Top的Y軸的值。

  四. 資料來源的定義

    在上面的設計中利用到了佔位符,這個也是比較合理的一種做法,在列印的過程中替換佔位符中的內容。 在系統啟動的時候回檢測模板中的所有佔位符。

    資料來源的定義是以Dictionary<string, object> 為基礎型別,為什麼什麼這麼做,我在佔位符 比如{{Logo}} 定義如上,我們就在Dictionary 查詢LogoKey的值。然後將其中的內容值替換即可

    如果是Loop標籤的資料來源如何處理: 在Loop標籤中定義了Values的屬性,其屬性值也就是Dictionary 中的key,查詢得到之後仍然是一個List<Dictionary<string,object>>的資料值,這邊便於迴圈和Key值得查詢。

dic = new Dictionary<string, object>();
            dic.Add("Logo", @"D:\222.jpg");
            dic.Add("OrderNO", "V3454596546565");
            dic.Add("Cashier", "菜霞");
            dic.Add("EndPoint", "634");
            dic.Add("Number", "120457");
            dic.Add("CreateTime", DateTime.Now.ToString("yyyy-MM0dd HH:mm:ss"));
            dic.Add("Amount", "65223.00");
            dic.Add("QRCode", "V3454596546565");

            List<Dictionary<string, object>> Info = new List<Dictionary<string, object>>()
            {
                new Dictionary<string, object>() { { "No", "1"},{ "ProductNum", "120223"},{ "ProductName", "中華煙"},{ "Qty", "2"},{ "Price", "49"},{ "Amount", "98"} },
                new Dictionary<string, object>() { { "No", "2"},{ "ProductNum", "565666"},{ "ProductName", "玻璃杯"},{ "Qty", "7"},{ "Price", "45"},{ "Amount", "45545"} },
                new Dictionary<string, object>() { { "No", "3"},{ "ProductNum", "897845"},{ "ProductName", "菸灰缸"},{ "Qty", "5"},{ "Price", "2435"},{ "Amount", "67767"} },
                new Dictionary<string, object>() { { "No", "4"},{ "ProductNum", "904395"},{ "ProductName", "茶几"},{ "Qty", "3"},{ "Price", "45245"},{ "Amount", "6767"} },
            };
            dic.Add("Qty", "5");
            dic.Add("TotalAmount", "1045.00");
            dic.Add("DiscountQty", "1");
            dic.Add("DiscountAmount", "40.00");
            dic.Add("Discount", "47.5");
            dic.Add("DiscountMon", "1958.00");
            dic.Add("List", Info);
資料來源基本格式
public partial class DocumentPrintControl
    {
        public DocumentPrintControl() { }

        public DocumentPrintControl(string printName,string filePath,Dictionary<string,object> dataSource,bool isAutoHeigth)
        {
            this.PrintName = printName;
            this.FilePath = filePath;
            this.DataSource = dataSource;
            this.IsAutoHeigth = isAutoHeigth;
        }

        /// <summary>
        /// 印表機名稱
        /// </summary>
        public string PrintName { get; set; }

        /// <summary>
        /// 列印模板路徑
        /// </summary>
        public string FilePath { get; set; }

        /// <summary>
        /// 列印資料來源
        /// </summary>
        public Dictionary<string, object> DataSource { get; set; }

        /// <summary>
        /// 是否自適應高度
        /// </summary>
        public bool IsAutoHeigth { get; set; }

        /// <summary>
        /// 列印Document
        /// </summary>
        private PrintDocument printDocument;

        /// <summary>
        /// 列印對話方塊
        /// </summary>
        private PrintDialog printDialog;

        /// <summary>
        /// XML解析文件
        /// </summary>
        private XDocument root;

        /// <summary>
        /// 初始化
        /// </summary>
        /// <returns></returns>
        public DocumentPrintControl Init()
        {
            this.printDialog = new PrintDialog();
            this.printDocument = new PrintDocument();
            this.printDialog.Document = this.printDocument;
            this.printDocument.PrintPage += PrintDocument_PrintPage;

            return this;
        }

        /// <summary>
        /// 設定資料來源
        /// </summary>
        /// <param name="dataSource"></param>
        /// <returns></returns>
        public DocumentPrintControl SetDataSource(string fileName)
        {
            string line = string.Empty;
            this.DataSource = new Dictionary<string, object>();
            using (StreamReader reader = new StreamReader(fileName,Encoding.Default))
            {
                List<Dictionary<string, object>> list = new List<Dictionary<string, object>>();
                while ((line = reader.ReadLine()) != null)
                {
                    Dictionary<string, object> dic = new Dictionary<string, object>();
                    dic.Add("Line", line);
                    list.Add(dic);
                }
                this.DataSource.Add("List", list);
            }
            return this;
        }

        /// <summary>
        /// 開始命令
        /// </summary>
        /// <returns></returns>
        public DocumentPrintControl Begin()
        {
            //列印模板
            if (!File.Exists(this.FilePath))
            {
                throw new Exception("列印模板檔案不存在");
            }

            this.root = XDocument.Load(this.FilePath);

            string strWidth = root.Element("Page").Attribute("Width").Value;
            string strHeigth = root.Element("Page").Attribute("Heigth").Value;
            strWidth = string.IsNullOrWhiteSpace(strWidth) ? "0" : strWidth;
            strHeigth = string.IsNullOrWhiteSpace(strHeigth) ? "0" : strHeigth;
            string DefaultPrinter = root.Element("Page").Attribute("DefaultPrinter").Value;

            //計算文件高度
            if (this.IsAutoHeigth)
            {
                float PageHeith = 0;
                foreach (XElement item in root.Element("Page").Elements())
                {
                    if (item.Name == "Line")
                    {
                        float LineHeigth = string.IsNullOrWhiteSpace(item.Attribute("Height").Value) ? 0 : Convert.ToSingle(item.Attribute("Height").Value);
                        PageHeith += LineHeigth;
                    }
                    else if (item.Name == "Loop")
                    {
                        string Values = item.Attribute("Values").Value;
                        List<Dictionary<string, object>> listValues = this.DataSource[Values] as List<Dictionary<string, object>>;
                        if (listValues != null)
                        {
                            XElement lineItem = item.Element("Line");
                            float LineHeigth = string.IsNullOrWhiteSpace(lineItem.Attribute("Height").Value) ?