WinForm 自定义圆角文本框（`TextBox`）的核心实现路径在于重写控件的绘制逻辑，即利用 `System.Drawing.Graphics` 命名空间下的绘图 API，在控件的客户区（`ClientRectangle`）内构造并绘制一个圆角矩形路径，以此作为文本框的视觉边界。其技术本质是创建一个继承自 `UserControl` 或直接继承自 `TextBox` 的自定义控件，并重写其 `OnPaint` 方法或 `WndProc` 方法以拦截绘制消息 [ref_1]。 ### 一、核心实现原理与技术选型 自定义圆角文本框并非修改原生 `TextBox` 的内部绘制机制，而是构建一个**复合控件**或**完全自绘控件**。博客中采用的方法是创建一个 `UserControl`，并在其内部嵌入一个标准的 `TextBox` 控件作为文本输入载体，然后由 `UserControl` 负责绘制圆角边框和背景。这种做法的优势在于： 1. **功能解耦**：文本输入、选择、滚动、焦点管理等复杂交互逻辑完全由内嵌的标准 `TextBox` 负责，无需重新实现。 2. **外观定制**：外层的 `UserControl` 通过 `Graphics` 绘图，可以自由定义边框、背景、圆角半径等视觉属性，实现了外观与行为的分离。 3. **属性与事件透传**：通过将内嵌 `TextBox` 的常用属性（如 `Text`, `Font`, `ForeColor`）和事件（如 `TextChanged`, `KeyUp`）暴露为自定义控件的公共成员，保持了与原生控件近乎一致的编程接口。 ### 二、关键实现步骤与代码解析 以下流程与代码示例整合了博客中的实践方案 [ref_1]： **步骤1：创建自定义控件类** 创建一个继承自 `UserControl` 的类，例如 `RoundedTextBox`。 ```csharp using System.Drawing; using System.Drawing.Drawing2D; using System.Windows.Forms; namespace CustomControls { public partial class RoundedTextBox : UserControl { // 内嵌的标准文本框 private TextBox innerTextBox = new TextBox(); public RoundedTextBox() { InitializeComponent(); // 初始化内嵌文本框，设置其停靠方式为填充，并移除边框 innerTextBox.BorderStyle = BorderStyle.None; innerTextBox.Dock = DockStyle.Fill; // 将内嵌文本框添加到当前用户控件的控件集合中 this.Controls.Add(innerTextBox); // 设置用户控件的初始样式 this.BackColor = Color.White; this.borderColor = Color.Gray; this.BorderRadius = 8; } // 自定义属性：圆角半径 private int borderRadius = 5; public int BorderRadius { get { return borderRadius; } set { borderRadius = value; this.Invalidate(); } // 修改后重绘 } // 自定义属性：边框颜色 private Color borderColor; public Color BorderColor { get { return borderColor; } set { borderColor = value; this.Invalidate(); } } // 透传内嵌文本框的Text属性 public override string Text { get { return innerTextBox.Text; } set { innerTextBox.Text = value; } } // ... 其他需要透传的属性（Font, ForeColor, MaxLength等）和事件 } } ``` **步骤2：重写 `OnPaint` 方法进行绘制** 这是实现圆角外观的核心。绘制逻辑包括填充圆角背景和绘制圆角边框。 ```csharp protected override void OnPaint(PaintEventArgs e) { base.OnPaint(e); Graphics g = e.Graphics; g.SmoothingMode = SmoothingMode.AntiAlias; // 启用抗锯齿，使边缘平滑 Rectangle rect = this.ClientRectangle; // 为了绘制时边框完整，通常将绘制区域向内收缩一个像素 rect.Inflate(-1, -1); // 1. 填充圆角背景 using (GraphicsPath path = GetRoundedRectanglePath(rect, BorderRadius)) using (SolidBrush brush = new SolidBrush(this.BackColor)) { g.FillPath(brush, path); } // 2. 绘制圆角边框 using (GraphicsPath path = GetRoundedRectanglePath(rect, BorderRadius)) using (Pen pen = new Pen(borderColor, 1)) // 边框宽度为1 { g.DrawPath(pen, path); } } // 辅助方法：构造圆角矩形路径 private GraphicsPath GetRoundedRectanglePath(Rectangle rect, int radius) { GraphicsPath path = new GraphicsPath(); int diameter = radius * 2; Rectangle arcRect = new Rectangle(rect.Location, new Size(diameter, diameter)); // 左上角 path.AddArc(arcRect, 180, 90); // 上边线 path.AddLine(rect.Left + radius, rect.Top, rect.Right - radius, rect.Top); // 右上角 arcRect.X = rect.Right - diameter; path.AddArc(arcRect, 270, 90); // 右边线 path.AddLine(rect.Right, rect.Top + radius, rect.Right, rect.Bottom - radius); // 右下角 arcRect.Y = rect.Bottom - diameter; path.AddArc(arcRect, 0, 90); // 下边线 path.AddLine(rect.Right - radius, rect.Bottom, rect.Left + radius, rect.Bottom); // 左下角 arcRect.X = rect.Left; path.AddArc(arcRect, 90, 90); // 左边线 path.AddLine(rect.Left, rect.Bottom - radius, rect.Left, rect.Top + radius); path.CloseFigure(); return path; } ``` **步骤3：处理控件状态变化** 为了使控件在禁用、获得焦点等状态下有不同外观，需要监听相关事件并触发重绘。例如，可以在 `OnEnabledChanged` 方法中改变背景色并调用 `Invalidate()`。 ```csharp protected override void OnEnabledChanged(EventArgs e) { base.OnEnabledChanged(e); // 当控件被禁用时，改变内嵌文本框的背景色 innerTextBox.BackColor = this.Enabled ? this.BackColor : SystemColors.Control; this.Invalidate(); // 请求重绘自定义边框和背景 } ``` ### 三、技术要点与潜在优化 | 技术维度 | 说明与考量 | | :--- | :--- | | **性能考量** | 频繁的 `OnPaint` 调用和 `GraphicsPath` 创建可能影响性能。可在控件大小、颜色等属性变化时才调用 `Invalidate()`，并考虑在 `GetRoundedRectanglePath` 方法中使用缓存机制。 | | **高DPI支持** | 在高DPI显示器上，直接使用像素坐标可能导致绘制模糊。应使用 `Graphics.DpiX` 和 `Graphics.DpiY` 进行DPI感知的缩放计算。 | | **焦点视觉提示** | 标准 `TextBox` 在获得焦点时有闪烁的光标和系统定义的点状边框。自定义控件需要额外绘制焦点状态，例如在 `OnPaint` 中判断 `this.Focused` 并绘制一个不同颜色的外框。 | | **输入体验** | 内嵌的 `TextBox` 必须留有足够的内边距（Padding），确保文字不会绘制到圆角区域。这可以通过设置 `innerTextBox.Location` 和 `Size` 时考虑 `BorderRadius` 的值来实现。 | | **可访问性** | 自定义控件应正确实现 `AccessibleObject`，以便屏幕阅读器等辅助技术能够识别和描述控件。 | ### 四、应用场景与扩展 此方案适用于对 WinForm 应用程序 UI 有较高定制化要求的场景，如： * **现代化桌面应用**：需要扁平化、圆角化设计以符合当代审美。 * **品牌化软件**：需要将企业品牌色、特定视觉元素融入标准控件。 * **专业工具软件**：需要通过颜色、形状区分不同功能状态的输入区域（如校验成功为绿色圆角框，失败为红色）。 基于此模式，开发者可以进一步扩展，实现渐变背景、阴影效果、动画过渡（结合 Timer）等更复杂的视觉效果，从而构建出一套完整的、风格统一的 WinForm 自定义控件库。