如何实现C# TextBox多行文本中某一行的边框高亮？

Question

如何在C# WinForms的TextBox多行文本中实现指定行的边框高亮？由于TextBox控件本身不支持行级样式渲染，无法直接为某一行添加边框。常见的问题是：使用Graphics绘制边框时坐标计算不准，导致高亮位置偏移；或在文本滚动、换行时高亮区域无法同步更新。此外，当文本内容动态变化时，行高和行数的计算易出错，影响高亮准确性。如何结合字体高度、行距和文本内容精确计算目标行的矩形区域，并在Paint事件中正确绘制边框，成为实现该功能的关键技术难点。

Answer 1

一、引言：TextBox控件的样式局限性与高亮需求

C# WinForms中的TextBox控件是基础且广泛使用的输入控件，支持多行文本显示。然而，其原生设计并不支持行级样式控制，如为特定行添加边框、背景色或字体加粗等视觉增强功能。

在实际开发中，例如日志查看器、代码编辑器预览模块或配置文件编辑工具，用户常需要对某一行或多行进行视觉高亮，以突出关键信息。但由于TextBox无法直接操作行渲染，开发者必须借助GDI+手动绘制，这带来了坐标计算、滚动同步和动态更新等一系列挑战。

二、核心难点分析

实现指定行边框高亮的主要技术难点包括：

1. 坐标系统不匹配：TextBox内部使用逻辑文本坐标，而Graphics绘图基于像素坐标，需精确转换。
2. 自动换行影响行数：当WordWrap = true时，物理行（屏幕显示行）与逻辑行（文本中的\n分隔行）数量不同。
3. 滚动偏移未考虑：垂直滚动条位置改变后，绘制区域未相应平移，导致高亮错位。
4. 字体与行高计算误差：不同字体、DPI设置下，Font.Height不能完全代表实际行高。
5. 重绘时机不足：文本变更、大小调整或滚动时未触发重绘，造成高亮滞后或丢失。

三、关键技术路径分解

步骤	技术要点	说明
1. 自定义控件继承	继承TextBox并重写OnPaint	TextBox默认不公开Paint事件，需通过继承实现自绘能力
2. 获取目标行范围	GetLineFromCharIndex + MeasureString	结合字符索引与文本测量，确定每行起始位置及宽度
3. 计算绘制矩形	考虑边距、滚动偏移、行高	使用ClientRectangle和VerticalScroll.Value校正坐标
4. GDI+绘制边框	Graphics.DrawRectangle(Pen, Rect)	建议使用半透明Brush填充背景提升可读性
5. 同步更新机制	监听TextChanged、Scroll、Resize事件	确保内容变化后立即重绘

四、代码实现示例

public class HighlightedTextBox : TextBox
{
    private int _highlightedLine = -1;
    private readonly Pen _borderPen = new Pen(Color.Red, 2);
    private readonly Brush _bgBrush = new SolidBrush(Color.FromArgb(30, 255, 0, 0));

    public int HighlightedLine
    {
        get => _highlightedLine;
        set
        {
            _highlightedLine = value;
            this.Invalidate(); // 触发重绘
        }
    }

    protected override void OnCreateControl()
    {
        base.OnCreateControl();
        this.SetStyle(ControlStyles.UserPaint | ControlStyles.AllPaintingInWmPaint, true);
        this.UpdateStyles();
    }

    protected override void WndProc(ref Message m)
    {
        base.WndProc(ref m);
        if (m.Msg == 0x00F) // WM_PAINT
            this.Invalidate();
    }

    protected override void OnPaint(PaintEventArgs e)
    {
        base.OnPaint(e);

        if (_highlightedLine < 0 || _highlightedLine >= GetLineCount())
            return;

        Graphics g = e.Graphics;
        Font font = this.Font;
        float lineHeight = font.GetHeight(g);

        int firstCharIndex = GetFirstCharIndexFromLine(_highlightedLine);
        int lastCharIndex = GetFirstCharIndexFromLine(_highlightedLine + 1) - 1;
        if (lastCharIndex < 0) lastCharIndex = this.TextLength - 1;

        string lineText = this.Text.Substring(firstCharIndex, lastCharIndex - firstCharIndex + 1);
        SizeF textSize = g.MeasureString(lineText, font, int.MaxValue, StringFormat.GenericTypographic);

        float x = 3; // 左边距补偿
        float y = _highlightedLine * lineHeight - this.VerticalScroll.Value * lineHeight + 2;

        RectangleF highlightRect = new RectangleF(x, y, Math.Max(textSize.Width, 1), lineHeight);

        g.FillRectangle(_bgBrush, highlightRect);
        g.DrawRectangle(_borderPen, Rectangle.Round(highlightRect));
    }

    private int GetLineCount()
    {
        return this.Lines.Length;
    }
}
    

五、Mermaid流程图：高亮绘制逻辑流程

graph TD
            A[开始绘制] --> B{是否设置了HighlightedLine?}
            B -- 否 --> C[结束]
            B -- 是 --> D[获取目标行文本]
            D --> E[测量文本宽度]
            E --> F[计算行高与Y坐标]
            F --> G[考虑滚动条偏移]
            G --> H[构建高亮矩形区域]
            H --> I[使用Graphics绘制边框与背景]
            I --> J[结束]

六、进阶优化策略

• 双缓冲防闪烁：启用SetStyle(ControlStyles.OptimizedDoubleBuffer, true)减少重绘抖动。
• 支持多行高亮：将_highlightedLine扩展为HashSet<int>集合。
• 精确换行处理：对于WordWrap=true场景，需逐字符遍历并模拟断行逻辑。
• DPI感知适配：在高DPI显示器上使用Graphics.DpiX校正尺寸。
• 性能优化：仅在必要时调用Invalidate()，避免频繁重绘整个控件。
• 兼容性测试：验证不同字体（如Consolas、SimSun）、字号、RightToLeft布局下的表现。

七、替代方案对比

方案	优点	缺点
RichTextBox + Selection	原生支持样式，易实现	选中状态干扰用户操作，无法保留原有选择
WebBrowser + HTML	强大样式控制，支持CSS	资源占用高，跨进程通信复杂
第三方编辑器（Scintilla, AvalonEdit）	功能完整，专业级体验	引入外部依赖，增加部署复杂度
自定义TextBox绘制（本文方案）	轻量、可控、无依赖	需深入GDI+和文本布局知识