应选UserControl：适合功能聚合，如带搜索框+下拉列表+清除按钮的“智能输入框”；若语义明确为按钮（如“提交订单”）且需原生行为，则继承Button。
直接继承 Button 或 UserControl 是最稳妥的起点，别一上来就重写 Control —— 90% 的需求用不到那么底层，反而容易漏掉焦点、键盘导航、DPI 缩放等隐性支持。
该选 UserControl 还是继承 Button？
看控件是否“语义明确”：如果它在业务逻辑中就是个按钮（比如“提交订单”“重试连接”），且需要原生按钮的所有行为（空格触发、Tab 键可聚焦、PerformClick() 可调用），就直接继承 Button；如果它是一组控件的组合（比如带搜索框 + 下拉列表 + 清除按钮的“智能输入框”），那就用 UserControl。
常见错误现象：UserControl 拖进窗体后双击不触发事件、无法通过 Tab 键进入、右键菜单不显示“属性”——本质是没设置 TabStop = true、没重写 OnCreateControl() 初始化关键状态、或忘了在设计器文件里把基类改成 UserControl（Visual Basic 中尤其容易卡在这）。
- 继承
Button：适合外观/行为微调，如带计数器、渐变背景、点击动画 - 继承
UserControl：适合功能聚合，如日期范围选择器、带图标和提示的输入框 - 继承
Control：仅当需要完全控制绘制+消息循环，且明确放弃标准交互支持时才考虑
OnPaint 重写必须调用 base.OnPaint() 吗？
对 Button 等标准控件子类，必须调用。因为 base.OnPaint() 不只画背景，还负责绘制边框、焦点矩形、禁用态灰度、高 DPI 自适应缩放等——这些你手动画几乎不可能兼容所有系统设置。
使用场景：你想在按钮文字上方加一个角标（如“NEW”）、在右下角画一个小图标、或者用 Graphics.DrawString() 替换默认文本渲染（比如支持换行或自定义字体间距）。
性能影响：每次重绘都走 GDI+，若在 OnPaint 里创建新 Brush 或 Font 实例（而非复用字段），会触发 GC 压力。正确做法是把 SolidBrush、StringFormat 等作为私有字段缓存，在 Dispose() 里释放。
示例关键片段：
private SolidBrush _textBrush = new SolidBrush(Color.Purple);
protected override void OnPaint(PaintEventArgs e)
{
base.OnPaint(e); // 必须先让基类画完
e.Graphics.DrawString("Clicked", Font, _textBrush, new PointF(5, 5));
}
如何让自定义控件出现在工具箱并支持设计时属性？
不是编译完就能自动出现。VS 工具箱只扫描项目输出目录下的 DLL，并且要求类型满足两个硬条件：public、有无参构造函数、继承自 Control 或其子类（UserControl 也算）。
容易踩的坑：
- 类名或命名空间含特殊字符（如中文、短横线），导致工具箱加载失败
- 项目目标框架是 .NET Core/.NET 5+，但工具箱只加载面向 .NET Framework 的控件库（WinForms 设计器目前仍依赖 Framework 运行时）
- 属性没加
[Browsable(true)]和[Category("Appearance")]，导致属性面板里不显示 - 事件没加
[Description("点击时触发")]，鼠标悬停无提示
实操建议：新建项目时选“Windows Forms 控件库”模板（不是“类库”），它会自动配置好 TargetFramework 和设计器支持；添加控件后，右键项目 → “重新生成”，再右键工具箱 → “选择项” → 浏览到输出目录下的 DLL 即可。
为什么 OnClick 里调 Invalidate() 后界面没刷新？
大概率是控件没获得有效句柄（Handle 为空），而 Invalidate() 在没有句柄时静默失败。常见于控件刚 new 出来还没加入窗体控件树，或在异步线程里误调用了 Invalidate()。
正确做法：
- 确保
OnClick执行时控件已加载（IsHandleCreated == true） - 避免在
BackgroundWorker或Task.Run里直接调用 UI 方法；改用Invoke((MethodInvoker)delegate { Invalidate(); }) - 如果只是想更新文字，优先用属性触发重绘（例如新增
public int ClickCount { get; private set; }，在OnClick里改值后调Invalidate()），而不是在OnClick里直接操作Graphics
复杂点在于：WinForms 的绘制不是“立即执行”，而是标记区域后等待 WM_PAINT 消息。所以 Invalidate() 后看不到变化，未必是代码错，可能是窗体被遮挡、控件 Visible = false、或父容器 AutoScroll = true 导致重绘区域计算异常——这些都要逐层排查，不能只盯 OnPaint。
