如何快速获取WinForms中RichTextBox单个字符的背景色？

要解决逐个选中字符导致的性能低下、界面闪烁及滚动位置偏移问题，可通过Win32原生API直接读取指定位置字符的格式信息，无需修改控件选中状态或可见性。

实现方案 #

1. 定义Win32交互接口 #

首先引入System.Runtime.InteropServices命名空间，定义与RichTextBox通信所需的API和格式结构体：

using System.Runtime.InteropServices;

public static class RichTextBoxNative
{
    private const int WM_USER = 0x0400;
    public const int EM_GETCHARFORMAT = WM_USER + 58;
    public const int SCF_RANGE = 0x0008; // 指定获取范围格式

    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Auto)]
    public struct CHARFORMAT2
    {
        public int cbSize;
        public uint dwMask;
        public uint dwEffects;
        public int yHeight; // 当使用SCF_RANGE时，存储起始字符索引
        public int yOffset; // 当使用SCF_RANGE时，存储结束字符索引（不包含）
        public int crTextColor;
        public byte bCharSet;
        public byte bPitchAndFamily;
        [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 32)]
        public string szFaceName;
        public ushort wWeight;
        public ushort sSpacing;
        public int crBackColor; // 背景色字段
        public int lcid;
        public uint dwReserved;
        public short sStyle;
        public short wKerning;
        public byte bUnderlineType;
        public byte bAnimation;
        public byte bRevAuthor;
        public byte bReserved1;
    }

    [DllImport("user32.dll", CharSet = CharSet.Auto)]
    public static extern IntPtr SendMessage(IntPtr hWnd, int msg, IntPtr wParam, ref CHARFORMAT2 lParam);
}

2. 封装字符背景色获取方法 #

编写工具方法，直接读取指定索引字符的背景色，无需修改控件选中状态：

private Color GetCharBackColor(RichTextBox rtb, int charIndex)
{
    // 校验索引有效性
    if (charIndex < 0 || charIndex >= rtb.TextLength)
        return Color.Empty;

    var charFormat = new RichTextBoxNative.CHARFORMAT2();
    charFormat.cbSize = Marshal.SizeOf(charFormat);
    // 指定要获取背景色，且使用范围模式
    charFormat.dwMask = 0x200 | 0x4000; // CFM_BACKCOLOR | CFM_RANGE
    // 设置范围为当前单个字符：起始索引charIndex，结束索引charIndex+1
    charFormat.yHeight = charIndex;
    charFormat.yOffset = charIndex + 1;

    // 发送消息获取格式信息
    RichTextBoxNative.SendMessage(rtb.Handle, RichTextBoxNative.EM_GETCHARFORMAT, 
                                  (IntPtr)RichTextBoxNative.SCF_RANGE, ref charFormat);

    // 将COLORREF格式转换为Color对象
    return Color.FromArgb(charFormat.crBackColor);
}

3. 计算标记文本的起止范围 #

使用上述方法遍历所有字符，定位所有特定背景色字符的起止位置：

private TextRange? CalcMarkedTextRange()
{
    var rtb = RichTextBox;
    int textLength = rtb.TextLength;
    int markBegins = -1;
    int markEnds = -1;

    for (int ix = 0; ix < textLength; ix++)
    {
        Color currentBackColor = GetCharBackColor(rtb, ix);
        if (currentBackColor == SelectedTextBackColor)
        {
            if (markBegins == -1)
                markBegins = ix;
            markEnds = ix;
        }
    }

    return markBegins != -1 
        ? new TextRange(markBegins, markEnds - markBegins + 1) 
        : null;
}

方案优势 #

• 性能大幅提升：通过原生API直接读取格式，避免了频繁的UI更新操作，处理上万字符也能保持流畅。
• 无界面闪烁：无需隐藏控件，全程保持界面可见，消除闪烁问题。
• 不干扰用户操作：无需修改控件选中状态和滚动位置，完全保留用户当前的操作状态。

内容的提问来源于stack exchange，提问作者Charles Jenkins