FillConsoleOutputAttribute

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

FillConsoleOutputAttribute函数设置指定数量的字符单元格的文本和背景颜色属性,从屏幕缓冲区中的指定坐标开始。

BOOL FillConsoleOutputAttribute(

HANDLE 【hConsoleOutput】,//处理屏幕缓冲区
WORD 【wAttribute】,//颜色属性写
DWORD 【nLength】,//要写入的字符单元格数
COORD 【dwWriteCoord】,//第一个单元格的x坐标和y坐标
LPDWORD 【lpNumberOfAttrsWritten】//指向写入的单元格数的指针
); 

参数

【hConsoleOutput】

标识一个屏幕缓冲区。句柄必须具有GENERIC_WRITE权限。

【wAttribute】

指定要写入屏幕缓冲区的前景色和背景颜色属性。可以指定以下值的任意组合:FOREGROUND_BLUE,FOREGROUND_GREEN,FOREGROUND_RED,FOREGROUND_INTENSITY,BACKGROUND_BLUE,BACKGROUND_GREEN,BACKGROUND_RED和BACKGROUND_INTENSITY。例如,以下值的组合在黑色背景上产生白色文本:

FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_BLUE

【nLength】

指定要设置为指定颜色属性的字符单元格数。

【dwWriteCoord】

指定包含要设置其属性的第一个单元格的屏幕缓冲区坐标的COORD结构。

【lpNumberOfAttrsWritten】

指向接收其属性实际设置的字符单元数的变量。

返回值

如果函数成功,返回值不为零。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

如果要设置其属性的字符单元的数量超出屏幕缓冲区中指定行的结尾,则设置下一行的单元格。如果要写入的单元数量超出屏幕缓冲区的结尾,则单元格将写入屏幕缓冲区的末尾。

写入位置的字符值不变。

也可以看看

COORD, FillConsoleOutputCharacter, SetConsoleTextAttribute, WriteConsoleOutputAttribute