SetConsoleTextAttribute功能设置由WriteFile或WriteConsole功能写入屏幕缓冲区的字符的前景(文本)和背景颜色属性,或由ReadFile或ReadConsole功能回显。此函数仅影响函数调用后写入的文本。
BOOL SetConsoleTextAttribute(
HANDLE 【hConsoleOutput】, | //控制台屏幕缓冲区的句柄 |
WORD 【wAttributes】 | //文字和背景颜色 |
); |
参数
【hConsoleOutput】
标识控制台屏幕缓冲区。句柄必须具有GENERIC_READ权限。
【wAttributes】
指定前景色和背景颜色属性。可以指定以下值的任意组合:FOREGROUND_BLUE,FOREGROUND_GREEN,FOREGROUND_RED,FOREGROUND_INTENSITY,BACKGROUND_BLUE,BACKGROUND_GREEN,BACKGROUND_RED和BACKGROUND_INTENSITY。例如,以下值的组合在黑色背景上产生白色文本:
FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_BLUE
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
要确定屏幕缓冲区的当前颜色属性,请调用GetConsoleScreenBufferInfo功能。
也可以看看
GetConsoleScreenBufferInfo, ReadConsole, ReadFile, WriteConsole, WriteFile