WinForms圆角按钮控件异常求助：初始可用后出错，优化后显黑方块

问题概述 #

• 自定义WinForms圆角按钮，初期运行正常，后续出现异常
• 采用ChatGPT提供的代码修改后，编译器无警告，但控件显示为黑方块
• 预期实现带有圆角的按钮样式

初始代码 #

using System;
using System.Drawing;
using System.Windows.Forms;

public class RoundedButton : Button
{
    public int CornerRadius { get; set; } = 20;

    protected override void OnPaint(PaintEventArgs pevent)
    {
       
        using (GraphicsPath path = new GraphicsPath())
        {
            path.AddArc(0, 0, CornerRadius, CornerRadius, 180, 90);
            path.AddArc(Width - CornerRadius, 0, CornerRadius, CornerRadius, 270, 90);
            path.AddArc(Width - CornerRadius, Height - CornerRadius, CornerRadius, CornerRadius, 0, 90);
            path.AddArc(0, Height - CornerRadius, CornerRadius, CornerRadius, 90, 90);
            path.CloseFigure();

            this.Region = new Region(path);
        }

        using (SolidBrush brush = new SolidBrush(BackColor))
        {
            pevent.Graphics.FillPath(brush, path);
        }

       
        TextRenderer.DrawText(pevent.Graphics, Text, Font, ClientRectangle, ForeColor, TextFormatFlags.HorizontalCenter | TextFormatFlags.VerticalCenter);
    }
}

ChatGPT修改后的代码 #

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Drawing.Drawing2D;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace BookMs
{
    public partial class RoundButton : Button
    {
        private float radius;
        public RoundButton()
        {
            InitializeComponent();
        }
        [Description("The radius of the arc.")]
        [Category("Behavior")]
        public float CornerRadius
        {
            set
            {
                this.radius = value;
            }
            get
            {
                return this.radius;
            }
        }
        protected override void OnPaint(PaintEventArgs e)
        {
            if (CornerRadius <= 0) return; // 防止 CornerRadius 不合理的情况

            using (GraphicsPath path = new GraphicsPath())
            {
                float diameter = CornerRadius * 2;
                // 确保 CornerRadius 不超过控件大小
                diameter = Math.Min(diameter, Math.Min(Width, Height));

                // 添加四个角的圆弧
                path.AddArc(0, 0, diameter, diameter, 180, 90);
                path.AddArc(Width - diameter, 0, diameter, diameter, 270, 90);
                path.AddArc(Width - diameter, Height - diameter, diameter, diameter, 0, 90);
                path.AddArc(0, Height - diameter, diameter, diameter, 90, 90);
                path.CloseFigure();

                this.Region = new Region(path);

                using (SolidBrush brush = new SolidBrush(BackColor))
                {
                    e.Graphics.FillPath(brush, path);
                }
            }

            TextRenderer.DrawText(e.Graphics, Text, Font, ClientRectangle, ForeColor, TextFormatFlags.HorizontalCenter | TextFormatFlags.VerticalCenter);
        }
    }
}

问题分析与修复方案 #

1. 初始代码的核心问题 #

初始代码中，path对象在第一个using块内创建并释放，后续调用FillPath时再次使用已释放的path，直接导致对象已释放异常，这就是后续运行异常的根源。

2. ChatGPT修改后显示黑方块的原因 #

• CornerRadius未设置默认值，初始值为0，触发if (CornerRadius <= 0) return;逻辑，控件没有执行任何绘制操作，因此显示为黑方块
• 保留了InitializeComponent()，但自定义控件无需调用设计器生成的该方法
• 未关闭Button的默认绘制逻辑，容易引发背景绘制冲突

修复后的完整代码 #

using System;
using System.Drawing;
using System.Drawing.Drawing2D;
using System.Windows.Forms;

namespace BookMs
{
    public class RoundButton : Button
    {
        private float _cornerRadius = 20f;

        [Description("圆角半径")]
        [Category("外观")]
        public float CornerRadius
        {
            get => _cornerRadius;
            set
            {
                _cornerRadius = Math.Max(0, value);
                Invalidate(); // 修改属性后立即触发控件重绘
            }
        }

        public RoundButton()
        {
            // 开启自定义绘制相关样式，关闭默认绘制逻辑，避免冲突
            SetStyle(ControlStyles.UserPaint | ControlStyles.AllPaintingInWmPaint | ControlStyles.OptimizedDoubleBuffer, true);
        }

        protected override void OnPaint(PaintEventArgs e)
        {
            e.Graphics.SmoothingMode = SmoothingMode.AntiAlias; // 开启抗锯齿，让圆角边缘更平滑

            float diameter = Math.Min(CornerRadius * 2, Math.Min(Width, Height));
            if (diameter <= 0)
            {
                // 半径为0时按普通按钮逻辑绘制
                base.OnPaint(e);
                return;
            }

            using (GraphicsPath path = new GraphicsPath())
            {
                // 构建圆角路径
                path.AddArc(0, 0, diameter, diameter, 180, 90);
                path.AddArc(Width - diameter, 0, diameter, diameter, 270, 90);
                path.AddArc(Width - diameter, Height - diameter, diameter, diameter, 0, 90);
                path.AddArc(0, Height - diameter, diameter, diameter, 90, 90);
                path.CloseFigure();

                // 设置控件区域，裁剪圆角外的内容
                Region = new Region(path);

                // 绘制按钮背景
                using (SolidBrush bgBrush = new SolidBrush(BackColor))
                {
                    e.Graphics.FillPath(bgBrush, path);
                }

                // 绘制按钮边框（可选，可根据需求调整颜色和宽度）
                using (Pen borderPen = new Pen(ForeColor, 1))
                {
                    e.Graphics.DrawPath(borderPen, path);
                }
            }

            // 绘制按钮文本
            TextRenderer.DrawText(e.Graphics, Text, Font, ClientRectangle, ForeColor, 
                TextFormatFlags.HorizontalCenter | TextFormatFlags.VerticalCenter);
        }
    }
}

关键修复点说明 #

• 给CornerRadius设置默认值20f，避免初始值为0导致不绘制
• 属性修改时调用Invalidate()，确保控件实时更新样式
• 开启UserPaint等控件样式，彻底关闭默认绘制逻辑，消除冲突
• 添加抗锯齿设置，提升圆角的视觉效果
• 确保所有依赖path的操作都在using块内完成，避免对象释放后使用
• 增加半径为0时的兼容处理，保留普通按钮的绘制逻辑

内容的提问来源于stack exchange，提问作者William Yue