设置级别颜色 - LogSetLevelColor

函数简介

设置指定日志级别的控制台输出颜色。

接口名称

LogSetLevelColor

DLL调用

int32_t LogSetLevelColor(int64_t instance, int64_t loggerHandle, int32_t level, int32_t color)

参数说明

参数名类型说明
instanceint64_tOLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成
loggerHandleint64_t日志实例句柄（0 表示默认实例）
levelint32_t日志级别，见 LogLevel 枚举
colorint32_t控制台颜色，见 LogConsoleColor 枚举

LogConsoleColor 枚举值

枚举值值说明
OLA_LOG_COLOR_BLACK0x00黑色
OLA_LOG_COLOR_DARK_BLUE0x01深蓝色
OLA_LOG_COLOR_DARK_GREEN0x02深绿色
OLA_LOG_COLOR_DARK_CYAN0x03深青色
OLA_LOG_COLOR_DARK_RED0x04深红色
OLA_LOG_COLOR_DARK_MAGENTA0x05深洋红色
OLA_LOG_COLOR_DARK_YELLOW0x06深黄色
OLA_LOG_COLOR_GRAY0x07灰色
OLA_LOG_COLOR_DARK_GRAY0x08深灰色
OLA_LOG_COLOR_BLUE0x09蓝色
OLA_LOG_COLOR_GREEN0x0A绿色
OLA_LOG_COLOR_CYAN0x0B青色
OLA_LOG_COLOR_RED0x0C红色
OLA_LOG_COLOR_MAGENTA0x0D洋红色
OLA_LOG_COLOR_YELLOW0x0E黄色
OLA_LOG_COLOR_WHITE0x0F白色

示例

// 设置INFO级别为青色
int result = LogSetLevelColor(instance, 0, OLA_LOG_LEVEL_INFO, OLA_LOG_COLOR_CYAN);

// 设置ERROR级别为红色
int result = LogSetLevelColor(instance, 0, OLA_LOG_LEVEL_ERROR, OLA_LOG_COLOR_RED);

// 设置WARN级别为黄色
int result = LogSetLevelColor(instance, 0, OLA_LOG_LEVEL_WARN, OLA_LOG_COLOR_YELLOW);

// 自定义颜色方案
LogSetLevelColor(instance, 0, OLA_LOG_LEVEL_TRACE, OLA_LOG_COLOR_GRAY);
LogSetLevelColor(instance, 0, OLA_LOG_LEVEL_DEBUG, OLA_LOG_COLOR_CYAN);
LogSetLevelColor(instance, 0, OLA_LOG_LEVEL_INFO, OLA_LOG_COLOR_GREEN);
LogSetLevelColor(instance, 0, OLA_LOG_LEVEL_WARN, OLA_LOG_COLOR_YELLOW);
LogSetLevelColor(instance, 0, OLA_LOG_LEVEL_ERROR, OLA_LOG_COLOR_RED);
LogSetLevelColor(instance, 0, OLA_LOG_LEVEL_CRITICAL, OLA_LOG_COLOR_MAGENTA);

返回值

返回值说明
0失败
1成功

注意事项

  • 仅在控制台输出启用且颜色模式不为 NEVER 时生效
  • 修改后立即生效，如果日志系统已初始化，会自动重新初始化
  • 可以使用位或运算组合颜色，例如：OLA_LOG_COLOR_FOREGROUND_RED | OLA_LOG_COLOR_FOREGROUND_GREEN = 黄色
  • 添加 OLA_LOG_COLOR_FOREGROUND_INTENSITY (0x08) 可以使颜色变亮
Last Updated: