settextcolor参数如何正确设置颜色值？

setTextColor 是一个非常常见的函数名，主要用于在控制台、终端或图形界面中设置后续文本的显示颜色，虽然它在不同编程语言或库中的具体实现可能略有不同，但其核心功能和参数的含义是相通的。

下面我将从几个方面来解释它的参数：

1. 最常见的用法：直接指定颜色值
2. 进阶用法：使用颜色常量或枚举
3. 特殊参数：重置颜色
4. 不同语言/库中的具体示例

最常见的用法：直接指定颜色值

在很多实现中,setTextColor 可以接受一个数值作为参数，这个数值通常是通过将红色、绿色、蓝色三个颜色通道的值组合而成的。

参数格式：

setTextColor(颜色数值)

颜色数值如何计算？

颜色数值通常是 十六进制 格式，由 0x 开头，后面跟着6位十六进制数，格式为 0xRRGGBB。

• RR：红色的分量，范围是 00 到 FF (十进制 0 到 255)。
• GG：绿色的分量，范围是 00 到 FF (十进制 0 到 255)。
• BB：蓝色的分量，范围是 00 到 FF (十进制 0 到 255)。

示例：

// 假设这是一个函数调用
// 设置文本颜色为纯红色
setTextColor(0xFF0000); // FF (红色) + 00 (绿色) + 00 (蓝色)
// 设置文本颜色为纯绿色
setTextColor(0x00FF00);
// 设置文本颜色为纯蓝色
setTextColor(0x0000FF);
// 设置文本颜色为黄色 (红色 + 绿色)
setTextColor(0xFFFF00);
// 设置文本颜色为紫色 (红色 + 蓝色)
setTextColor(0xFF00FF);
// 设置文本颜色为青色 (绿色 + 蓝色)
setTextColor(0x00FFFF);
// 设置文本颜色为白色 (所有颜色都满)
setTextColor(0xFFFFFF);
// 设置文本颜色为灰色 (所有颜色分量相等)
setTextColor(0x808080);
// 设置文本颜色为黑色 (所有颜色分量都为0)
setTextColor(0x000000);

进阶用法：使用颜色常量或枚举

为了方便记忆和提高代码可读性,很多库或框架会预先定义好一些常用的颜色常量或枚举类型，你不需要自己记住 0xFF0000 是红色，直接使用 RED 即可。

参数格式：

setTextColor(颜色常量)

示例：

假设一个库定义了如下的颜色常量：

// 假设的颜色常量定义
#define RED     0xFF0000
#define GREEN   0x00FF00
#define BLUE    0x0000FF
#define YELLOW  0xFFFF00
#define WHITE   0xFFFFFF
#define BLACK   0x000000
#define CYAN    0x00FFFF
#define MAGENTA 0xFF00FF

那么调用方式就变得非常直观：

// 使用颜色常量，代码更易读
setTextColor(RED);
printf("这是一段红色的文本，\n");
setTextColor(GREEN);
printf("这是一段绿色的文本，\n");
setTextColor(BLUE);
printf("这是一段蓝色的文本，\n");

在面向对象的语言中（如 C++），这些常量通常被封装在一个 Color 枚举类中：

// C++ 示例
enum class Color {
    Red = 0xFF0000,
    Green = 0x00FF00,
    Blue = 0x0000FF,
    // ... 其他颜色
};
// 调用方式
setTextColor(Color::Red);

特殊参数：重置颜色

这是一个非常重要且常见的用法,如何将文本颜色恢复为默认的终端颜色（通常是黑色或白色）？

会有一个特殊的颜色值或一个专门的函数来实现这个功能。

使用特殊颜色值

有些库会使用 0 或 -1 来代表“默认颜色”或“重置颜色”。

// 设置颜色为红色
setTextColor(0xFF0000);
printf("红色文本");
// 重置为默认颜色
setTextColor(0); // 或者 setTextcolor(-1);
printf("这是默认颜色的文本。");

使用专门的函数

更规范的做法是提供一个单独的函数,resetColor() 或 setDefaultColor()。

// 设置颜色为红色
setTextColor(0xFF0000);
printf("红色文本");
// 重置为默认颜色
resetColor();
printf("这是默认颜色的文本。");

ANSI 转义码 (在大多数现代终端中有效)

在很多现代终端（如 Linux/macOS Terminal, Windows Terminal, VS Code Terminal）中，setTextColor 的功能是通过 ANSI 转义码 实现的，在这种情况下，参数的格式完全不同。

• 设置文本颜色： \033[38;2;R;G;Bm
• 重置所有样式： \033[0m

这里的 setTextColor "函数" 实际上是一个打印特殊字符串的操作。

// C 语言示例
#include <stdio.h>
void setTextColor(int r, int g, int b) {
    printf("\033[38;2;%d;%d;%dm", r, g, b);
}
void resetColor() {
    printf("\033[0m");
}
int main() {
    // 设置为深蓝色
    setTextColor(0, 0, 139);
    printf("这是一段深蓝色的文本，\n");
    // 设置为橙色
    setTextColor(255, 165, 0);
    printf("这是一段橙色的文本，\n");
    // 重置为默认颜色
    resetColor();
    printf("这是默认颜色的文本，\n");
    return 0;
}

不同语言/库中的具体示例

C++ (Windows API - SetConsoleTextAttribute)

在 Windows 控制台中，函数名是 SetConsoleTextAttribute，它的工作方式略有不同，它设置的是 前景色（文本） 和 背景色。

参数：

SetConsoleTextAttribute(控制台句柄, 属性值);

属性值 是一个 WORD 类型，它由前景色和背景色组合而成：

• 前景色（文本颜色）：
  • FOREGROUND_RED (4)
  • FOREGROUND_GREEN (2)
  • FOREGROUND_BLUE (1)
  • FOREGROUND_INTENSITY (8, 高亮/加亮)
• 背景色：
  • BACKGROUND_RED (64)
  • BACKGROUND_GREEN (32)
  • BACKGROUND_BLUE (16)
  • BACKGROUND_INTENSITY (128, 高亮背景)

你可以使用按位或 将它们组合起来。

#include <windows.h>
#include <iostream>
void setTextColor(int foreground, int background = 0) {
    HANDLE hConsole = GetStdHandle(STD_OUTPUT_HANDLE);
    SetConsoleTextAttribute(hConsole, foreground | background);
}
int main() {
    // 红色文本，默认背景
    setTextColor(FOREGROUND_RED);
    std::cout << "红色文本" << std::endl;
    // 绿色文本，蓝色背景
    setTextColor(FOREGROUND_GREEN, BACKGROUND_BLUE);
    std::cout << "绿色文本，蓝色背景" << std::endl;
    // 高亮白色文本
    setTextColor(FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_BLUE | FOREGROUND_INTENSITY);
    std::cout << "高亮白色文本" << std::endl;
    // 重置为默认
    setTextColor(FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_BLUE); // 白色
    std::cout << "默认颜色" << std::endl;
    return 0;
}

Python (使用 colorama 库)

Python 标准库中没有直接的全局 setTextColor，但第三方库 colorama 提供了跨平台的解决方案。

参数：

Fore.颜色常量 或 Back.颜色常量，然后使用 Style.RESET_ALL 来重置。

from colorama import Fore, Back, Style, init
# 初始化 colorama (适用于 Windows)
init()
print(Fore.RED + "这是红色文本" + Style.RESET_ALL)
print(Fore.GREEN + "这是绿色文本" + Style.RESET_ALL)
print(Fore.BLUE + Back.YELLOW + "这是蓝色文本，黄色背景" + Style.RESET_ALL)
print("这是默认颜色的文本")

要准确使用 setTextColor，最关键的一步是查阅你所使用的具体库或框架的官方文档，以确定它接受什么样的参数以及有哪些可用的预定义颜色。