简介这是一份面向C#初学者与桌面应用开发者的WinForm绘图程序源码基于.NET Framework构建可用于学习图层管理、图形绘制与图像保存等核心交互逻辑。程序支持新建图层并单独显示或隐藏可在不同图层上绘制线条、矩形、圆形等基础图形配合颜色选择器精确取色并提供可调大小的橡皮擦用于局部修正最终可将作品保存到磁盘以便后续查看或继续编辑。资源包共46个文件以cs源码、resx与resources资源文件、config配置、sln解决方案及exe可执行文件为主另含少量zbak备份与cache缓存文件压缩包约529KB结构完整可直接编译运行。目前已有45人学习下载适合作为WinForm图形编程入门练手项目帮助读者理解多图层绘制、颜色管理与文件保存的实现思路。1. 从一份 Painter.zip 说起Winform 绘图程序到底能落地到什么程度很多人第一次看到「C# Winform 绘图程序」这类资源第一反应是「这不就是大学课程设计吗」。但真正拆过 Painter.zip 的人会发现它把图层管理、图形绘制、颜色选择、橡皮擦、保存这几件事串成了一条完整链路而不是只画一条线就结束。这份资源的核心价值在于它用最朴素的 GDI 和 Winform 控件体系演示了一个可交互绘图工具的最小闭环。适合谁正在做 C# 上位机、需要给设备加简易标注面板的工程师想理解图层数据结构怎么设计的初学者以及需要一份能直接跑起来的 Winform 项目案例来改造成自己工具的人。它不追求 Photoshop 级别的功能但胜在结构清晰、依赖少、能编译、能改。2. 图层与绘图的核心机制从 Form1.cs 到 GDI 对象模型2.1 图层不是控件而是内存中的位图列表这份资源里最容易被低估的设计是图层的实现方式。很多新手会以为「新建图层」就是动态加一个 Panel 或 PictureBox但 Painter 的做法更接近真实绘图软件每个图层本质上是一张Bitmap所有绘制操作先落到当前图层的位图上最后在OnPaint里按顺序叠加绘制到窗体。这样做的好处是图层可以独立隐藏、独立擦除不会因为重绘顺序导致互相覆盖。常见做法是定义一个Layer类至少包含三个字段Bitmap Bitmap、string Name、bool Visible。然后用ListLayer管理所有图层currentLayerIndex记录当前活动图层。这个结构不复杂但决定了后面所有功能的实现难度。如果一开始把图层做成控件后面做「合并图层」「导出整图」时会非常痛苦。public class Layer { public Bitmap Bitmap { get; set; } public string Name { get; set; } public bool Visible { get; set; } public Layer(int width, int height, string name) { Bitmap new Bitmap(width, height); Name name; Visible true; } }逻辑说明每个图层持有自己的位图尺寸与画布一致。参数说明width、height通常取画布客户区大小name用于列表显示。注意位图创建后默认是全透明的GDI 绘制时要用Graphics.FromImage获取绘图表面。2.2 绘制线条、矩形、圆的统一入口Painter 里绘制图形不是每个按钮写一套逻辑而是用「工具模式」来区分。常见做法是定义一个枚举DrawTool { Line, Rectangle, Ellipse, Eraser }鼠标按下时记录起点鼠标移动时如果处于拖拽状态就实时预览鼠标抬起时把图形真正画到当前图层位图上。这里有个关键点预览不能直接画在位图上否则会留下残影。正确做法是在OnPaint里先画所有可见图层再用ControlPaint.DrawReversibleLine或临时 Graphics 画预览图形。更稳妥的方式是维护一个previewRect或previewLine变量在OnPaint最后根据当前鼠标位置绘制预览。private void canvas_MouseDown(object sender, MouseEventArgs e) { if (e.Button MouseButtons.Left) { startPoint e.Location; isDrawing true; } } private void canvas_MouseUp(object sender, MouseEventArgs e) { if (!isDrawing) return; using (Graphics g Graphics.FromImage(layers[currentLayerIndex].Bitmap)) { g.SmoothingMode System.Drawing.Drawing2D.SmoothingMode.AntiAlias; using (Pen pen new Pen(currentColor, penWidth)) { Rectangle rect GetRect(startPoint, e.Location); switch (currentTool) { case DrawTool.Line: g.DrawLine(pen, startPoint, e.Location); break; case DrawTool.Rectangle: g.DrawRectangle(pen, rect); break; case DrawTool.Ellipse: g.DrawEllipse(pen, rect); break; } } } isDrawing false; canvas.Invalidate(); }逻辑说明鼠标抬起时才真正写入图层位图避免拖拽过程中反复修改。参数说明currentColor来自颜色选择器penWidth控制线宽GetRect负责把两个点转成规范矩形。注意SmoothingMode.AntiAlias会让线条更平滑但也会轻微增加绘制开销。2.3 颜色选择与橡皮擦的实现差异颜色选择通常用ColorDialog但 Painter 这类程序往往会自己做一个调色板面板因为ColorDialog在频繁切换颜色时体验不好。自己实现的话可以用一个Panel加若干Button每个按钮的BackColor对应一个预设颜色点击后更新currentColor。橡皮擦的本质不是「擦除」而是用背景色或透明色绘制。如果图层支持透明橡皮擦应该把对应区域设为Color.Transparent但这在 GDI 里不能直接用Pen画需要用Graphics.CompositingMode CompositingMode.SourceCopy配合Color.Transparent的SolidBrush。更简单的做法是橡皮擦直接用画布背景色绘制适合不要求透明背景的场景。private void EraseAt(Point p) { using (Graphics g Graphics.FromImage(layers[currentLayerIndex].Bitmap)) { g.CompositingMode System.Drawing.Drawing2D.CompositingMode.SourceCopy; using (SolidBrush brush new SolidBrush(Color.Transparent)) { g.FillEllipse(brush, p.X - eraserSize / 2, p.Y - eraserSize / 2, eraserSize, eraserSize); } } }逻辑说明SourceCopy模式会用画刷颜色直接替换目标像素而不是混合。参数说明eraserSize控制橡皮擦直径通常做成可调。注意如果图层本身不透明透明擦除后显示的是下层图层或窗体背景需要确保OnPaint的叠加顺序正确。3. 从编译到运行Painter.sln 的实操路径与参数调整3.1 环境准备与项目结构确认拿到 Painter.zip 后先别急着双击 .sln。解压后确认目录里有Painter.sln、Painter.csproj、Form1.cs、Form1.Designer.cs、Program.cs这几个关键文件。如果缺少.csproj说明压缩包可能不完整。这份资源里还有App.config、Form2、Form3说明它至少有三个窗体常见分工是主绘图窗体、图层管理窗体、关于或设置窗体。开发环境建议用 Visual Studio 2015 或更高版本因为热词里vs2015出现频率很高而这个项目的目标框架大概率是 .NET Framework 4.5 左右。打开 .sln 后如果提示「目标框架未安装」在项目属性里把目标框架改成你机器上已有的版本比如 .NET Framework 4.7.2 或 4.8。不要直接升级到 .NET Core 或 .NET 5Winform 的 GDI 代码虽然大部分兼容但App.config和设计器序列化格式会有差异。# 解压后建议先检查文件完整性 unzip Painter.zip -d Painter cd Painter ls -la # 确认存在 Painter.sln 和 Painter.csproj逻辑说明先解压再检查避免直接在压缩包里打开导致路径错误。参数说明-d Painter指定解压目录ls -la查看隐藏文件和权限。注意如果压缩包里有中文文件名在部分系统上可能乱码建议用 7-Zip 或 Bandizip 解压。3.2 编译时最常见的三个报错与处理第一个报错通常是「找不到类型或命名空间」比如System.Drawing未引用。在解决方案资源管理器里右键「引用」→「添加引用」→「程序集」→ 勾选System.Drawing。第二个报错是资源文件冲突Form1.resx和Form1.Designer.cs不匹配常见于手动改过控件名。解决办法是删掉Form1.Designer.cs里对应的字段声明让设计器重新生成。第三个报错是App.config里的配置节不被识别如果项目没用到自定义配置节直接删掉App.config也能跑。!-- App.config 如果报配置节错误可以精简成这样 -- ?xml version1.0 encodingutf-8? configuration startup supportedRuntime versionv4.0 sku.NETFramework,Versionv4.7.2 / /startup /configuration逻辑说明supportedRuntime告诉运行时用哪个 .NET 版本。参数说明sku里的版本号要和你项目属性里的目标框架一致。注意不要保留不存在的configSections否则启动就崩。3.3 运行后的功能验证清单编译通过后按这个顺序验证功能能快速判断资源是否完整新建图层 → 在图层 1 画线 → 新建图层 2 → 画矩形 → 隐藏图层 1 → 确认矩形还在 → 切换颜色画圆 → 用橡皮擦擦掉一部分 → 保存为 BMP。如果某一步失败对应去查Form1.cs里的事件绑定。比如隐藏图层无效多半是OnPaint里没有判断layer.Visible保存出来是空白多半是保存时只保存了当前图层而不是合并后的画布。// 保存合并后的画布而不是单个图层 private void SaveAsBmp(string path) { using (Bitmap final new Bitmap(canvas.Width, canvas.Height)) { using (Graphics g Graphics.FromImage(final)) { foreach (var layer in layers) { if (layer.Visible) g.DrawImage(layer.Bitmap, Point.Empty); } } final.Save(path, System.Drawing.Imaging.ImageFormat.Bmp); } }逻辑说明新建一张与画布等大的位图按顺序叠加所有可见图层。参数说明path是保存路径ImageFormat.Bmp对应资源里的绘画样例.BMP。注意DrawImage的起点用Point.Empty如果图层有偏移需要相应调整。4. 避坑与排查图层、重绘、保存里的血泪经验4.1 现象画完图形后拖动窗口图形消失或闪烁原因Winform 的OnPaint在窗口重绘时会被反复调用如果绘制逻辑写在鼠标事件里而不是OnPaint里重绘后自然什么都不剩。另一个原因是没开双缓冲导致闪烁。解决把所有持久图形的绘制统一放到OnPaint里鼠标事件只负责修改数据。在窗体构造函数里设置DoubleBuffered true或者给自定义控件设置SetStyle(ControlStyles.OptimizedDoubleBuffer | ControlStyles.AllPaintingInWmPaint, true)。4.2 现象橡皮擦擦除后下层图层内容也被擦掉原因橡皮擦直接操作了合并后的画布而不是当前图层位图。或者CompositingMode设置不对导致透明擦除影响了叠加结果。解决确保橡皮擦只对layers[currentLayerIndex].Bitmap操作并且OnPaint里按图层顺序绘制。如果不需要透明擦除直接用背景色填充更简单避免SourceCopy带来的叠加问题。4.3 现象保存的 BMP 文件打开是纯黑或纯白原因新建Bitmap后没有清空背景或者Graphics没有正确绘制。另一个常见原因是保存路径没有写权限但这种情况通常会抛异常而不是生成空白文件。解决在SaveAsBmp里先g.Clear(Color.White)再叠加图层。如果图层本身有透明区域Clear的颜色就是最终背景色。保存前用final.Save(path)确认路径可写建议先保存到桌面测试。4.4 现象切换图层后新画的图形跑到旧图层上原因currentLayerIndex没有随图层列表选择变化而更新或者图层列表控件的SelectedIndexChanged事件没绑定。解决在图层列表的选中事件里显式更新currentLayerIndex并在状态栏显示当前图层名。如果用的是ListBox注意SelectedIndex可能为 -1要做边界判断。4.5 现象程序编译通过但运行时报「参数无效」原因GDI 的Pen宽度为 0 或负数或者Rectangle的宽高为负。鼠标拖拽时从右下往左上画GetRect没有做规范化。解决在GetRect里用Math.Min和Math.Abs处理坐标确保宽高为正。Pen宽度至少为 1橡皮擦大小至少为 2。private Rectangle GetRect(Point p1, Point p2) { int x Math.Min(p1.X, p2.X); int y Math.Min(p1.Y, p2.Y); int w Math.Abs(p1.X - p2.X); int h Math.Abs(p1.Y - p2.Y); return new Rectangle(x, y, w, h); }逻辑说明把任意两个点转成左上角加正宽高的矩形。参数说明p1、p2是鼠标按下和抬起的坐标。注意宽高为 0 时DrawRectangle不会报错但什么也画不出来这是正常的。5. 进阶用法把 Painter 改造成可复用的绘图控件5.1 把绘图逻辑从 Form1 抽成 UserControlPainter 的绘图逻辑目前和Form1耦合较深如果你想在多个项目里复用最直接的办法是新建一个UserControl把画布、图层列表、工具栏都放进去。关键是把ListLayer、currentTool、currentColor这些状态封装到控件内部对外只暴露SaveImage、LoadImage、AddLayer等方法。这样以后做 C# 上位机时可以直接把这个控件拖到主界面里当标注面板。public partial class PainterCanvas : UserControl { private ListLayer layers new ListLayer(); private int currentLayerIndex 0; private Color currentColor Color.Black; private DrawTool currentTool DrawTool.Line; public void AddLayer() { layers.Add(new Layer(Width, Height, $图层 {layers.Count 1})); currentLayerIndex layers.Count - 1; Invalidate(); } public void SaveImage(string path) { using (Bitmap final new Bitmap(Width, Height)) { using (Graphics g Graphics.FromImage(final)) { g.Clear(Color.White); foreach (var layer in layers) { if (layer.Visible) g.DrawImage(layer.Bitmap, Point.Empty); } } final.Save(path); } } }逻辑说明把状态和操作都收进控件外部只调方法。参数说明AddLayer自动命名并切换当前图层SaveImage合并所有可见图层后保存。注意Width、Height在控件未布局完成时可能为 0建议在Load事件里初始化第一张图层。5.2 用双缓冲和区域重绘优化性能当图层数量多、画布大时每次鼠标移动都Invalidate()整个画布会卡。优化方向有两个一是只重绘鼠标影响的区域用Invalidate(Rectangle)代替无参调用二是把不常变的图层缓存成一张位图只有当前图层变化时才重新合成。常见做法是维护一个compositeCache在图层增删或可见性变化时重建鼠标绘制时只更新当前图层并局部重绘。private Bitmap compositeCache; private void RebuildCache() { if (compositeCache ! null) compositeCache.Dispose(); compositeCache new Bitmap(Width, Height); using (Graphics g Graphics.FromImage(compositeCache)) { foreach (var layer in layers) { if (layer.Visible) g.DrawImage(layer.Bitmap, Point.Empty); } } }逻辑说明把所有可见图层预先合成到一张缓存位图OnPaint里直接画缓存。参数说明RebuildCache在图层变化时调用绘制过程中不调用。注意缓存位图要随控件大小变化重建否则会拉伸模糊。5.3 保存格式扩展与文件兼容性资源里只演示了 BMP 保存但实际用的时候往往需要 PNG 或 JPG。GDI 的ImageFormat支持直接切换PNG 支持透明JPG 不支持透明但体积小。如果你要保存图层信息以便下次编辑BMP 和 PNG 都不够需要自己序列化ListLayer到自定义格式比如用BinaryFormatter或 JSON 加 Base64 位图。常见做法是存一个 zip 包里面放一个layers.json和每层的 png 文件。格式透明支持体积是否保留图层适用场景BMP否大否快速验证、兼容老系统PNG是中否需要透明背景的导出JPG否小否照片类绘图、分享自定义 zip是中是继续编辑、存档逻辑说明表格对比了四种保存策略。参数说明自定义 zip 方案需要自己实现序列化和反序列化适合对可编辑性要求高的场景。注意BinaryFormatter在 .NET 5 已标记过时如果目标框架较新建议用System.Text.Json加位图转 Base64。从那以后我每次拿到这类 Winform 绘图资源都会先跑一遍「新建图层→画三种图形→隐藏→擦除→保存」这条链路确认图层叠加和重绘逻辑没问题再动手改。希望帮到你。本文还有配套的精品资源点击获取