WriteConsoleOutputAttribute功能将一些前景和背景颜色属性复制到控制台屏幕缓冲区的连续单元格,从指定位置开始。
BOOL WriteConsoleOutputAttribute(
HANDLE 【hConsoleOutput】, | //处理控制台屏幕缓冲区 |
CONST WORD *【lpAttribute】, | //指向缓冲区的指针写入属性 |
DWORD 【nLength】, | //要写入的字符单元格数 |
COORD 【wWriteCoord】, | //要写入的第一个单元格的坐标 |
LPDWORD 【lpNumberOfAttrsWritten】 | //指向写入的单元格数的指针 |
); |
参数
【hConsoleOutput】
标识屏幕缓冲区。句柄必须具有GENERIC_WRITE权限。
【lpAttribute】
指向包含要写入屏幕缓冲区的属性的缓冲区。
【nLength】
指定要写入的屏幕缓冲区字符单元的数量。
【dwWriteCoord】
指定要写入的屏幕缓冲区中第一个单元格的列和行坐标。
【lpNumberOfAttrsWritten】
指向接收实际写入屏幕缓冲区的属性数量的32位变量。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
如果要写入的属性数量超出屏幕缓冲区中指定行的结尾,则属性将写入下一行。如果要写入的属性数量超出屏幕缓冲区的结尾,则属性将写入屏幕缓冲区的末尾。
写入位置的字符值不变。
每个属性指定绘制该字符单元格的前景(文本)和背景颜色。属性值是以下值的一些组合:FOREGROUND_BLUE,FOREGROUND_GREEN,FOREGROUND_RED,FOREGROUND_INTENSITY,BACKGROUND_BLUE,BACKGROUND_GREEN,BACKGROUND_RED和BACKGROUND_INTENSITY。例如,以下值的组合在白色背景上产生红色文本:
FOREGROUND_RED | BACKGROUND_RED | BACKGROUND_GREEN | BACKGROUND_BLUE
也可以看看
ReadConsoleOutput, ReadConsoleOutputAttribute, ReadConsoleOutputCharacter, WriteConsoleOutput, WriteConsoleOutputCharacter