C# WinForm GUI最小化时RichText文本颜色异常问题

这个问题在WinForm的RichTextBox控件里挺常见的，核心原因是当窗体最小化时，RichTextBox的窗口句柄（Handle）会被系统销毁，控件进入“不可见/非激活”状态。这时候你设置文本颜色的操作，因为控件没有有效的绘制上下文，格式信息没有被正确写入控件的内部缓存，导致这段时间添加的文本默认显示为黑色。而当窗体最大化后，控件会重新创建句柄，之前的文本内容会被重新渲染，这时候颜色设置又能正常生效。

另外还有一种可能：你是通过SelectionColor结合文本选择范围来设置颜色的，但当控件不可见时，SelectionStart、SelectionLength这类和选择区域相关的属性会失效，导致颜色设置没有被正确应用到文本上。

针对这个问题，我给你几个可行的修复方案，按优先级排序：

1. 确保UI操作在主线程执行，且正确使用选择区域设置颜色 #

首先，不管窗体状态如何，所有更新RichTextBox的操作必须在UI线程执行（WinForm控件不是线程安全的）。然后使用标准的“选择-设置颜色-追加文本”流程，确保格式信息被正确写入：

private void AddColoredLogMessage(string message, Color textColor)
{
    // 跨线程调用检查，确保在UI线程执行
    if (richTextBox1.InvokeRequired)
    {
        richTextBox1.Invoke(new Action<string, Color>(AddColoredLogMessage), message, textColor);
        return;
    }

    // 保存当前控件的选择状态，避免覆盖用户可能的选择
    int originalSelectionStart = richTextBox1.SelectionStart;
    int originalSelectionLength = richTextBox1.SelectionLength;
    Color originalSelectionColor = richTextBox1.SelectionColor;

    try
    {
        // 将选择光标移到文本末尾，准备追加新内容
        richTextBox1.SelectionStart = richTextBox1.TextLength;
        richTextBox1.SelectionLength = 0;
        // 设置要追加文本的颜色
        richTextBox1.SelectionColor = textColor;
        // 追加文本（可以加换行符）
        richTextBox1.AppendText(message + Environment.NewLine);
    }
    finally
    {
        // 恢复原来的选择状态
        richTextBox1.SelectionStart = originalSelectionStart;
        richTextBox1.SelectionLength = originalSelectionLength;
        richTextBox1.SelectionColor = originalSelectionColor;
        // 强制控件刷新，确保格式生效
        richTextBox1.Invalidate();
        richTextBox1.Update();
    }
}

2. 改用Rtf格式直接写入（更可靠） #

RichTextBox的Rtf属性会完整保存文本的格式信息，即使控件句柄被销毁，只要你把带格式的Rtf内容正确写入，恢复可见时就能正常渲染。你可以把每条日志转换成对应的Rtf片段，然后追加到控件的Rtf属性中：

private void AddColoredLogMessageRtf(string message, Color textColor)
{
    if (richTextBox1.InvokeRequired)
    {
        richTextBox1.Invoke(new Action<string, Color>(AddColoredLogMessageRtf), message, textColor);
        return;
    }

    // 构建单条日志的Rtf片段
    string rtfFragment = $@"{{\rtf1\ansi\deff0{{\colortbl;\red0\green0\blue0;\red{textColor.R}\green{textColor.G}\blue{textColor.B};}}}}{{\cf2 {message}\line}}";

    // 处理原有Rtf内容，替换结束标记后追加新片段
    string currentRtf = richTextBox1.Rtf;
    if (currentRtf.EndsWith("}"))
    {
        currentRtf = currentRtf.Substring(0, currentRtf.Length - 1);
        currentRtf += rtfFragment + "}";
    }
    else
    {
        currentRtf += rtfFragment;
    }

    richTextBox1.Rtf = currentRtf;
}

3. 监听控件句柄重建事件，重新应用格式 #

如果你的日志内容是可以重新获取的，还可以监听RichTextBox的HandleCreated事件（句柄重建时触发，比如窗体最大化后），在事件里重新加载所有日志并设置颜色：

private void richTextBox1_HandleCreated(object sender, EventArgs e)
{
    // 清空现有内容，重新加载所有日志并设置颜色
    richTextBox1.Clear();
    foreach (var logEntry in YourLogList) // 假设YourLogList是保存所有日志的集合
    {
        AddColoredLogMessage(logEntry.Message, logEntry.Color);
    }
}

• 避免直接使用richTextBox.Text属性赋值带格式的文本，因为Text会丢失所有格式信息，只保留纯文本。
• 如果你的日志量很大，建议限制RichTextBox的行数（比如只保留最新的1000条），避免控件卡顿。

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