OLA 文档中心

主题

2026-08-20

设置级别颜色 - LogSetLevelColor ​

函数简介 ​

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

接口名称 ​

LogSetLevelColor

DLL调用 ​

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

参数说明 ​

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
loggerHandle长整数型日志实例句柄（0 表示默认实例）。
level整数型日志级别，见 LogLevel 枚举。
color整数型控制台颜色，见 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白色

高亮标志（可与其他颜色组合） ​

枚举值值说明
OLA_LOG_COLOR_FOREGROUND_INTENSITY0x08前景高亮（与颜色值按位或组合，使文字变亮）

位运算组合示例 ​

csharp
// 亮红色：红色 + 高亮标志
int color = 0x0C | 0x08;  // OLA_LOG_COLOR_RED | OLA_LOG_COLOR_FOREGROUND_INTENSITY
ola.LogSetLevelColor(3, color);  // 3 = ERROR 级别

// 普通绿色
ola.LogSetLevelColor(2, 0x0A);  // OLA_LOG_COLOR_GREEN
cpp
// 亮黄色警告
int color = 0x0E | 0x08;  // YELLOW + INTENSITY
ola.LogSetLevelColor(4, color);
python
# 亮青色信息
color = 0x0B | 0x08
ola.LogSetLevelColor(2, color)

示例 ​

将 INFO 设为青色 0x0B，打开控制台后验证。

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
const int64_t logger = 0; // 默认实例

ola.OpenConsole(0);
ola.LogSetTarget(logger, 2); // CONSOLE
ola.LogSetColorMode(logger, 1); // ALWAYS
int ret = ola.LogSetLevelColor(logger, 2, 0x0B); // INFO + CYAN
if (ret != 1) {
    return;
}
ola.LogInfo("info in cyan");
csharp
using System;
using OLAPlug;

var ola = new OLAPlugServer();
long logger = 0;

ola.OpenConsole(0);
ola.LogSetTarget(logger, 2); // CONSOLE
ola.LogSetColorMode(logger, 1); // ALWAYS
int ret = ola.LogSetLevelColor(logger, 2, 0x0B); // INFO + CYAN
if (ret != 1) return;
ola.LogInfo("info in cyan");
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
logger = 0

ola.OpenConsole(0)
ola.LogSetTarget(logger, 2)  # CONSOLE
ola.LogSetColorMode(logger, 1)  # ALWAYS
ret = ola.LogSetLevelColor(logger, 2, 0x0B)  # INFO + CYAN
if ret != 1:
    raise RuntimeError("failed")
ola.LogInfo("info in cyan")
java
import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
long logger = 0;

ola.OpenConsole(0);
ola.LogSetTarget(logger, 2); // CONSOLE
ola.LogSetColorMode(logger, 1); // ALWAYS
int ret = ola.LogSetLevelColor(logger, 2, 0x0B); // INFO + CYAN
if (ret != 1) {
    return;
}
ola.LogInfo("info in cyan");
go
import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
logger := int64(0)

ola.OpenConsole(0)
ola.LogSetTarget(logger, 2) // CONSOLE
ola.LogSetColorMode(logger, 1) // ALWAYS
ret := ola.LogSetLevelColor(logger, 2, 0x0B) // INFO + CYAN
if ret != 1 {
    return
}
ola.LogInfo("info in cyan")
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let logger = 0i64;

ola.open_console(0);
ola.log_set_target(logger, 2); // CONSOLE
ola.log_set_color_mode(logger, 1); // ALWAYS
let ret = ola.log_set_level_color(logger, 2, 0x0B); // INFO + CYAN
if ret != 1 {
    return;
}
ola.log_info("info in cyan");
cpp
var ola = com("OlaPlug.OlaSoft")
var logger = 0

ola.OpenConsole(0)
ola.LogSetTarget(logger, 2) // CONSOLE
ola.LogSetColorMode(logger, 1) // ALWAYS
var ret = ola.LogSetLevelColor(logger, 2, 0x0B) // INFO + CYAN
if(ret == 1) {
    ola.LogInfo("info in cyan")
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
logger = 0

ola.OpenConsole 0
ola.LogSetTarget logger, 2
ola.LogSetColorMode logger, 1
ret = ola.LogSetLevelColor(logger, 2, 0x0B)
If ret = 1 Then
    ola.LogInfo "info in cyan"
End If
text
.局部变量 ola, OLAPlug
.局部变量 ret, 整数型
.局部变量 logger, 长整数型

ola.Create ()
logger ＝ 0

ola.OpenConsole (0)
ola.LogSetTarget (logger, 2)  ' CONSOLE
ola.LogSetColorMode (logger, 1)  ' ALWAYS
ret ＝ ola.LogSetLevelColor (logger, 2, 0x0B)  ' INFO + CYAN
.如果真 (ret ＝ 1)
    ola.LogInfo (“info in cyan”)
.如果真结束
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var logger = 0;

ola.OpenConsole(0);
ola.LogSetTarget(logger, 2); // CONSOLE
ola.LogSetColorMode(logger, 1); // ALWAYS
var ret = ola.LogSetLevelColor(logger, 2, 0x0B); // INFO + CYAN
if(ret == 1){
    ola.LogInfo("info in cyan");
}
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 logger = 0

ola.OpenConsole(0)
ola.LogSetTarget(logger, 2)  ' CONSOLE
ola.LogSetColorMode(logger, 1)  ' ALWAYS
整数 ret = ola.LogSetLevelColor(logger, 2, 0x0B)  ' INFO + CYAN
如果真 (ret ＝ 1)
{
    ola.LogInfo("info in cyan")
}
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int64_t logger = 0;

ola.OpenConsole(0);
ola.LogSetTarget(logger, 2); // CONSOLE
ola.LogSetColorMode(logger, 1); // ALWAYS
int32_t ret = ola.LogSetLevelColor(logger, 2, 0x0B); // INFO + CYAN
if (ret != 1) {
    return;
}
ola.LogInfo("info in cyan");

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
long logger = 0;

OpenConsole(instance, 0);
LogSetTarget(instance, logger, 2);
LogSetColorMode(instance, logger, 1);
int ret = LogSetLevelColor(instance, logger, 2, 0x0B); // INFO, CYAN
if (ret != 1) {
    return;
}
LogInfo(instance, "info in cyan");
csharp
using System.Runtime.InteropServices;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int OpenConsole(long ola, int type);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetTarget(long ola, long loggerHandle, int targetFlags);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetColorMode(long ola, long loggerHandle, int colorMode);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetLevelColor(long ola, long loggerHandle, int level, int color);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogInfo(long ola, string message);

long instance = CreateCOLAPlugInterFace();
long logger = 0;

OpenConsole(instance, 0);
LogSetTarget(instance, logger, 2);
LogSetColorMode(instance, logger, 1);
int ret = LogSetLevelColor(instance, logger, 2, 0x0B);
if (ret != 1) return;
LogInfo(instance, "info in cyan");
python
from ctypes import CDLL, c_int, c_int64

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
logger = 0

ola.OpenConsole(instance, 0)
ola.LogSetTarget(instance, logger, 2)
ola.LogSetColorMode(instance, logger, 1)
ret = ola.LogSetLevelColor(instance, logger, 2, 0x0B)
if ret != 1:
    raise RuntimeError("LogSetLevelColor failed")
ola.LogInfo(instance, b"info in cyan")

返回值 ​

返回值说明
1成功。
0失败。

注意事项 ​

项目说明
仅在控制台输出启用且颜色模式不为 NEVER 时仅在控制台输出启用且颜色模式不为 NEVER 时生效。
修改后立即生效修改后立即生效，如果日志系统已初始化，会自动重新初始化。
OLA_LOG_COLOR_FOREGROUND_INTENSITY添加 OLA_LOG_COLOR_FOREGROUND_INTENSITY (0x08) 可以使颜色变亮。