书籍：《Visual C++ 2017从入门到精通》的2.3.8 Win32控件编程

环境：visual studio 2022

内容：【例2.33】字体选择对话框。

说明：以下内容大部分来自腾讯元宝。

SetTextColor() 函数深度解析
（基于 Windows GDI 的文本颜色管理功能）

---

​一、函数定义与核心功能

SetTextColor() 是 Windows API 中用于设置设备上下文（HDC）文本颜色的核心函数，其原型为：

COLORREF SetTextColor(HDC hdc, COLORREF crColor);

• ​功能：将指定设备上下文的文本前景色设置为 crColor，影响后续 TextOut、ExtTextOut 等函数的绘制效果。
• ​颜色范围：支持 RGB 颜色模式（0-255 范围）和预定义的系统颜色（如 CLR_INVALID）。

---

​二、参数解析

​参数	​说明
​hdc	设备上下文句柄，需通过 GetDC 或 BeginPaint 获取。
​crColor	颜色值，可通过 RGB(r, g, b) 宏生成，或直接使用预定义颜色常量（如 RGB(255,0,0) 表示红色）。

---

​三、返回值

• ​成功：返回上一个文本颜色的 COLORREF 值，可用于后续恢复默认颜色。
• ​失败：返回 CLR_INVALID，需通过 GetLastError() 获取扩展错误信息。

---

​四、颜色表示方法

1. ​RGB 颜色模式

   • 通过 RGB(r, g, b) 宏定义颜色，例如 RGB(255, 0, 0) 表示红色。
   • ​COLORREF 类型：实际存储为 32 位整数（0x00bbggrr 格式），其中蓝色占 8 位，绿色 8 位，红色 8 位。

2. ​系统预定义颜色

   • 如 COLOR_RED、COLOR_BLACK，可通过 GetSysColor 获取系统主题颜色。

---

​五、使用示例

基础用法

HDC hdc = GetDC(hwnd);
SetTextColor(hdc, RGB(0, 0, 255)); // 设置蓝色
TextOut(hdc, 10, 10, "Hello World", 11);
ReleaseDC(hwnd, hdc);

（参考网页示例代码）

在控件中应用

void CMyListCtrl::SetTextColor(COLORREF crNewColor) {
    CFont* pOldFont = GetFont();
    SelectObject(&m_font);
    SetTextColor(crNewColor); // 设置文本颜色
    SelectObject(pOldFont);
}

（参考网页MFC 控件定制代码）

---

​六、注意事项

1. ​颜色转换

   • 文本颜色用于位图灰度化转换（如 SetBkColor 配合 BitBlt）。
   • 若未调用绘图函数（如 TextOut），颜色设置不会生效。

2. ​资源管理

   • 需在操作完成后恢复原颜色（通过返回值 COLORREF），避免影响后续绘制。

3. ​跨设备兼容性

   • 不同设备（如屏幕与打印机）可能对颜色渲染有差异，建议使用逻辑颜色（通过 SetMapMode 设置）。

4. ​错误处理

   • 检查返回值是否为 CLR_INVALID，必要时调用 GetLastError() 定位问题。

---

​七、应用场景

1. ​动态文本颜色
   • 根据状态切换颜色（如选中项高亮、错误提示红色）。
2. ​图形与文本混合绘制
   • 结合 SetBkColor 实现背景色与文本色的对比效果。
3. ​跨平台兼容
   • Windows 程序中直接使用 SetTextColor，Android 可通过资源文件设置颜色（如 tv.setTextColor(R.color.red)）。

---

​总结

SetTextColor() 是 Windows GDI 中控制文本颜色的核心接口，其设计通过颜色值与设备上下文的绑定，实现了灵活的图形渲染。实际开发中需注意颜色管理、资源恢复及跨设备兼容性，复杂场景可结合 CDC 类（如 MFC）进行高级定制。