SetConsoleTextAttribute

【勇芳软件工作室】汉化HomePreviousNext

SetConsoleTextAttribute功能设置由WriteFileWriteConsole功能写入屏幕缓冲区的字符的前景(文本)和背景颜色属性,或由ReadFileReadConsole功能回显。此函数仅影响函数调用后写入的文本。

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