C# WinForms 实现打印监听组件

技术分享 9个月前 (06-15) 0 999+

关注

一、组件简介

打印监听组件是一款集成于 Windows 桌面环境的打印任务管理与监控工具，适用于企业级应用场景。它不仅支持多打印机任务的实时监控，还能通过 WebSocket 与外部系统集成，实现自动化打印、任务状态反馈、远程控制等功能。

二、界面功能介绍

1. 主界面与托盘集成

主窗体：采用 WinForms 界面，包含多标签页（TabControl），每个标签页对应一台本地打印机，便于分组管理。

托盘图标：程序最小化后驻留于系统托盘，双击可快速还原主界面，支持右键菜单操作（如退出、重启、服务设置等）。

2. 打印机管理

打印机列表：自动检测本地所有已安装打印机，支持设置默认打印机、查看打印机属性。

/// <summary> /// 绑定本地打印机列表到菜单 /// </summary> internal void BindPrintersToMenu() {     默认打印机ToolStripMenuItem.DropDownItems.Clear();     // 获取当前系统默认打印机     string defaultPrinter = new System.Drawing.Printing.PrinterSettings().PrinterName;      // 先添加默认打印机（始终第一行）     var defaultItem = new ToolStripMenuItem(defaultPrinter)     {         Checked = true     };     defaultItem.Click += (s, e) => SetDefaultPrinterUI(defaultPrinter);     // 添加“首选项”子菜单     var prefItem = new ToolStripMenuItem("首选项");     prefItem.Click += (s, e) => ShowPrinterProperties(defaultPrinter);     defaultItem.DropDownItems.Add(prefItem);     默认打印机ToolStripMenuItem.DropDownItems.Add(defaultItem);      // 再添加其他打印机（排除默认打印机）     foreach (string printer in System.Drawing.Printing.PrinterSettings.InstalledPrinters)     {         if (printer == defaultPrinter)             continue;          var item = new ToolStripMenuItem(printer)         {             Checked = false         };         item.Click += (s, e) => SetDefaultPrinterUI(printer);          var prefItem2 = new ToolStripMenuItem("首选项");         prefItem2.Click += (s, e) => ShowPrinterProperties(printer);         item.DropDownItems.Add(prefItem2);          默认打印机ToolStripMenuItem.DropDownItems.Add(item);     }  }  /// <summary>    /// UI和系统都设置默认打印机   /// </summary>    /// <param name="printerName"></param>    private void SetDefaultPrinterUI(string printerName)  {      foreach (ToolStripMenuItem item in 默认打印机ToolStripMenuItem.DropDownItems)          item.Checked = item.Text == printerName;       // 如需设置为系统默认打印机，可调用 Win32 API（可选）        SetSystemDefaultPrinter(printerName);  }  /// <summary> /// 显示打印机首选项对话框 /// </summary> /// <param name="printerName"></param> private void ShowPrinterProperties(string printerName) {     // 使用rundll32调用打印机属性对话框     //string args = $"printui.dll,PrintUIEntry /p /n "{printerName}"";     //•	/e 参数表示直接打开“首选项”对话框     string args = $"printui.dll,PrintUIEntry /e /n "{printerName}"";     var psi = new System.Diagnostics.ProcessStartInfo     {         FileName = "rundll32.exe",         Arguments = args,         UseShellExecute = false,         CreateNoWindow = true     };     try     {         System.Diagnostics.Process.Start(psi);     }     catch (Exception ex)     {         MessageBox.Show("无法打开打印机首选项窗口：" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);     } }

TabControl：每台打印机一个标签页，便于查看和管理各自的打印任务。

 /// <summary>  /// 绑定本地打印机列表到TabControl  /// </summary>  private void BindPrintersToTabControl()  {      tabControl1.TabPages.Clear();       string defaultPrinter = new System.Drawing.Printing.PrinterSettings().PrinterName;      List<string> printers = new List<string>();       // 先将默认打印机添加到列表首位      printers.Add(defaultPrinter);       // 再添加其他打印机（排除默认打印机）      foreach (string printer in System.Drawing.Printing.PrinterSettings.InstalledPrinters)      {          if (printer != defaultPrinter)              printers.Add(printer);      }       foreach (string printer in printers)      {          var tabPage = new TabPage(printer);          // 创建DataGridView          var dgv = new DataGridView          {              Dock = DockStyle.Fill,              ReadOnly = true,              AllowUserToAddRows = false,              AllowUserToDeleteRows = false,              RowHeadersVisible = false,              AutoSizeColumnsMode = DataGridViewAutoSizeColumnsMode.Fill          };           // 添加列          dgv.Columns.Add("clientIp", "来源");          dgv.Columns.Add("taskId", "任务ID");          dgv.Columns.Add("taskName", "任务名称");          dgv.Columns.Add("realName", "模板");          dgv.Columns.Add("requestTime", "开始时间");          dgv.Columns.Add("status", "任务状态");           //绑定菜单          dgv.ContextMenuStrip = dgvContextMenu;          dgv.MouseDown += Dgv_MouseDown;           // 创建TextBox          var txtSearch = new TextBox          {              PlaceholderText = "任务ID",              Width = 120,              Anchor = AnchorStyles.Left | AnchorStyles.Bottom          };           // 创建Button          var btnSearch = new Button          {              Text = "查找",              Width = 60,              Anchor = AnchorStyles.Left | AnchorStyles.Bottom          };           // 查找事件          btnSearch.Click += (s, e) =>          {              string searchId = txtSearch.Text.Trim();              bool found = false;              foreach (DataGridViewRow row in dgv.Rows)              {                  if (row.IsNewRow) continue;                  if (row.Cells["taskId"].Value?.ToString() == searchId)                  {                      row.Selected = true;                      dgv.CurrentCell = row.Cells["taskId"];                      found = true;                  }                  else                  {                      row.Selected = false;                  }              }              if (!found)              {                  MessageBox.Show("未找到对应任务ID！", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information);              }          };           // 使用Panel布局          var panel = new Panel          {              Dock = DockStyle.Bottom,              Height = 40          };          txtSearch.Location = new Point(10, 8);          btnSearch.Location = new Point(140, 6);          panel.Controls.Add(txtSearch);          panel.Controls.Add(btnSearch);           tabPage.Controls.Add(panel);          tabPage.Controls.Add(dgv);          tabControl1.TabPages.Add(tabPage);      }  }

3. 打印任务监控

任务列表：每个打印机标签页下方为 DataGridView，实时显示当前打印任务，包括来源、任务ID、任务名称、模板、开始时间、任务状态等信息。

右键菜单：支持对单个任务进行“取消打印”、“重新打印”、“删除记录”等操作。

任务搜索：支持按任务ID快速定位任务。

4. 其他功能

服务控制：可一键启动/停止 WebSocket 服务，支持与外部系统通信。
模板设计与预览：集成 FastReport 设计器和预览器，方便模板维护。

因为FastReport.Net 是需要购买授权的，所以我使用的是FastReport.OpenSource(开源版)，开源版功能太少，不能直接从程序内部调用FastReport设计器和预览器，只能通过启动本地安装的.exe来实现。

/// <summary> /// 设计菜单项点击事件，启动 FastReport 设计器 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> private void 设计ToolStripMenuItem_Click(object sender, EventArgs e) {     string designerPath = GetConfigValue("designer_path");     string templatePath = GetTemplatePathFromConfig();     if (string.IsNullOrEmpty(designerPath) || !System.IO.File.Exists(designerPath))     {         MessageBox.Show("未找到 FastReport 设计器，请检查 config.ini 配置！", "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);         return;     }     if (!System.IO.File.Exists(templatePath))     {         MessageBox.Show("未找到模板文件，请检查路径！", "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);         return;     }     try     {         System.Diagnostics.Process.Start(designerPath, $""{templatePath}"");     }     catch (Exception ex)     {         MessageBox.Show("启动 FastReport 设计器失败：" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);     } } private void 预览ToolStripMenuItem_Click(object sender, EventArgs e) {     string viewerPath = GetConfigValue("viewer_path");     string templatePath = GetTemplatePathFromConfig();     if (string.IsNullOrEmpty(viewerPath) || !System.IO.File.Exists(viewerPath))     {         MessageBox.Show("未找到 FastReport 预览器，请检查 config.ini 配置！", "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);         return;     }     if (!System.IO.File.Exists(templatePath))     {         MessageBox.Show("未找到模板文件，请检查路径！", "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);         return;     }     try     {         System.Diagnostics.Process.Start(viewerPath, $""{templatePath}"");     }     catch (Exception ex)     {         MessageBox.Show("启动 FastReport 预览器失败：" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);     } }

自动更新：支持在线检查和自动更新程序版本。

这里使用的是：Autoupdater.NET

帮助与支持：内置开发者联系方式，便于用户反馈和技术支持。

三、技术要点

1. 打印任务监听与管理

WMI 打印作业监控
通过 System.Management 命名空间，使用 WMI 查询 Win32_PrintJob，实现对打印队列的实时监控。可根据任务ID或文档名唯一标识，精确定位和管理打印作业。

using System.Management;   /// <summary>  /// 打印机监听方法实现  /// </summary>  /// <param name="printerName"></param>  /// <param name="taskId"></param>  private void StartMonitorPrintJob(string printerName, int taskId, string taskName)  {      Task.Run(() =>      {          try          {              string query = $"SELECT * FROM Win32_PrintJob WHERE Name LIKE '%{printerName}%'";              using (var searcher = new ManagementObjectSearcher(query))              {                  while (true)                  {                      var jobs = searcher.Get();                      bool found = false;                      foreach (ManagementObject job in jobs)                      {                          found = true;                          int JobId = Convert.ToInt32(job["JobId"]);                          if (JobId == taskId)                          {                              // 匹配到本任务，更新状态                              string jobStatus = job["JobStatus"]?.ToString() ?? "";                              string status = job["Status"]?.ToString() ?? "";                              string displayStatus = string.IsNullOrEmpty(jobStatus) ? status : jobStatus;                              UpdateTaskStatusOnUI(printerName, taskName, displayStatus);                              if (displayStatus.Contains("Printed") || displayStatus.Contains("Completed") || displayStatus.Contains("Deleted"))                                  return;                          }                      }                      if (!found)                      {                          // 作业已消失，认为已完成                          UpdateTaskStatusOnUI(printerName, taskName, "已完成");                          return;                      }                      Thread.Sleep(1000); // 1秒轮询                  }              }          }          catch (Exception ex)          {              UpdateTaskStatusOnUI(printerName, taskName, "状态监听失败");          }      });  }

任务状态同步
通过轮询方式定时查询打印队列，自动更新任务状态（如“正在打印”、“已完成”、“已取消”等），并在 UI 上实时反馈。

2. 打印任务操作

取消打印
通过 WMI 删除指定打印作业，确保任务被及时从队列中移除，并同步更新界面状态。

 /// <summary>  /// 取消打印  /// </summary>  /// <param name="sender"></param>  /// <param name="e"></param>  private void CancelPrint_Click(object sender, EventArgs e)  {      var dgv = GetCurrentDgv();      if (dgv == null) return;      var row = dgv.SelectedRows.Count > 0 ? dgv.SelectedRows[0] : null;      if (row == null) return;      int taskId = Convert.ToInt32(row.Cells["taskId"].Value);      string printerName = tabControl1.SelectedTab.Text;      // 查询打印队列，找到文档名包含 taskId 的作业      string query = $"SELECT * FROM Win32_PrintJob WHERE Name LIKE '%{printerName}%'";      using (var searcher = new System.Management.ManagementObjectSearcher(query))      {          foreach (System.Management.ManagementObject job in searcher.Get())          {              int JobId = Convert.ToInt32(job["JobId"]);              if (JobId == taskId)              {                  try                  {                      job.Delete(); // 删除打印任务                      row.Cells["status"].Value = "已取消";                      MessageBox.Show($"已取消打印任务：{taskId}", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information);                  }                  catch (Exception ex)                  {                      MessageBox.Show("取消打印失败：" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);                  }                  return;              }          }      }      MessageBox.Show("未找到对应的打印任务，可能已完成或被清除。", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information);  }

重新打印
首次打印时将所有参数（文件路径、数据、模板名等）保存在 DataGridView 行的 Tag 属性，重新打印时直接复用原始参数，保证打印一致性。

 /// <summary>  /// 重新打印  /// </summary>  /// <param name="sender"></param>  /// <param name="e"></param>  private void Reprint_Click(object sender, EventArgs e)  {      var dgv = GetCurrentDgv();      if (dgv == null) return;      var row = dgv.SelectedRows.Count > 0 ? dgv.SelectedRows[0] : null;      if (row == null) return;      if (row.Tag is PrintTaskInfo info)      {          // 复用原 taskName，或可选生成新 taskName          string taskName = row.Cells["taskName"].Value.ToString();          string status = row.Cells["status"].Value.ToString();          if (status == "已完成")              PrintFile(info.FilePath, info.Data, taskName);      }      else      {          MessageBox.Show("未找到原始打印信息，无法重新打印。", "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);      }  }

删除记录
支持在任务未完成时先删除打印队列中的作业，再移除界面记录，防止“假删除”导致队列堆积。

/// <summary> /// 删除打印记录 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> private void DeleteRecord_Click(object sender, EventArgs e) {     var dgv = GetCurrentDgv();     if (dgv == null) return;     var row = dgv.SelectedRows.Count > 0 ? dgv.SelectedRows[0] : null;     if (row == null) return;      int taskId = Convert.ToInt32(row.Cells["taskId"].Value);     string status = row.Cells["status"].Value?.ToString();     string printerName = tabControl1.SelectedTab.Text;     // 如果未完成，先删除打印队列中的任务     if (status != "已完成" && status != "已取消")     {         string query = $"SELECT * FROM Win32_PrintJob WHERE Name LIKE '%{printerName}%'";         using (var searcher = new System.Management.ManagementObjectSearcher(query))         {             foreach (System.Management.ManagementObject job in searcher.Get())             {                 int JobId = Convert.ToInt32(job["JobId"]);                 if (JobId == taskId)                 {                     try                     {                         job.Delete(); // 删除打印任务                     }                     catch (Exception ex)                     {                         MessageBox.Show("删除打印任务失败：" + ex.Message, "错误", MessageBoxButtons.OK, MessageBoxIcon.Error);                     }                     break;                 }             }         }     }     dgv.Rows.Remove(row); }

3. WebSocket 通信

Fleck 组件集成
使用 Fleck 实现 WebSocket 服务端，支持外部系统通过网络下发打印任务、查询状态、远程控制等。
消息协议设计
采用 JSON 协议，支持多种命令（如 print、show、ping 等），并能将打印结果、错误信息实时反馈给客户端。

socket.OnMessage = message => {     var msg = message?.Trim().ToLowerInvariant();     // 处理不同的消息     if (msg == "ping")     {         // 回复 pong         socket.Send("pong");     }     else if (msg == "show")     {         // 显示主窗体         this.Invoke(() =>         {             this.Show();             this.WindowState = FormWindowState.Normal;             this.ShowInTaskbar = true;             this.Activate();         });     }     else if (msg != null && msg.TrimStart().StartsWith("{"))     {         // 反序列化为 JsonNode 便于动态访问         var json = JsonNode.Parse(msg);         var cmd = json?["cmd"]?.ToString();         string requestId = json?["requestid"]?.ToString();         //处理打印任务         if (cmd == "print")         {             // 取出 printIniInfo 和 data             var printIniInfo = json["data"]?["printiniinfo"];             var data = json["data"]?["data"];             string filePath = printIniInfo?["filepath"]?.ToString();             string realName = printIniInfo?["realname"]?.ToString();              // 获取来源IP和端口             string clientIp = socket.ConnectionInfo.ClientIpAddress;             int clientPort = socket.ConnectionInfo.ClientPort;             string requestTime = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss");             string status = "作业正在后台处理";             // 获取当前系统默认打印机             string printerName = new System.Drawing.Printing.PrinterSettings().PrinterName;             int taskId = 0;             // 任务名称为当前时间             string taskName = DateTime.Now.ToString("yyyyMMddHHmmssfff");             // 查找对应TabPage和DataGridView             this.Invoke(() =>             {                 foreach (TabPage tab in tabControl1.TabPages)                 {                     // 支持“(默认)”后缀                     if (tab.Text.StartsWith(printerName))                     {                         var dgv = tab.Controls.OfType<DataGridView>().FirstOrDefault();                         if (dgv != null)                         {                             int rowIndex = dgv.Rows.Add(                                  $"{clientIp}:{clientPort}", // 来源                                  taskId,                     // 任务ID                                  taskName,                   // 任务名称                                  realName,                   // 模板                                  requestTime,                // 开始时间                                  status                      // 任务状态                              );                             var row = dgv.Rows[rowIndex];                             row.Tag = new PrintTaskInfo                             {                                 FilePath = filePath,                                 Data = data                             };                             // 添加后排序                             dgv.Sort(dgv.Columns["requestTime"], ListSortDirection.Descending);                         }                         break;                     }                 }             });             // 调用实际打印方法             this.Invoke(() => PrintFile(filePath, data, taskName, socket, requestId));              //监听打印机状态             StartMonitorPrintJob(printerName, taskId, taskName);         }         else         {             // 处理其他cmd             Console.WriteLine($"收到未知cmd: {cmd}");         }     }     else     {         Console.WriteLine($"收到未知消息: {message}");     } };