C# WinForms 实现打印监听组件

当前位置：点晴教程→知识管理交流 →『技术文档交流』

admin

2025年6月22日 0:15 本文热度 100

一、组件简介

打印监听组件是一款集成于 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}");    }};