FillConsoleOutputCharacter

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

FillConsoleOutputCharacter函数从指定的坐标开始,将一个字符写入屏幕缓冲区指定的次数。

BOOL FillConsoleOutputCharacter(

HANDLE 【hConsoleOutput】,//处理屏幕缓冲区
TCHAR 【// character to write】,//要写的字符
DWORD 【nLength】,//要写入的字符单元格数
COORD 【dwWriteCoord】,//第一个单元格的x坐标和y坐标
LPDWORD 【lpNumberOfCharsWritten】//指向写入的单元格数的指针
); 

参数

【hConsoleOutput】

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

【// character to write】

指定要写入屏幕缓冲区的字符。

【nLength】

指定要写入字符的字符单元格数。

【dwWriteCoord】

指定一个COORD结构,其中包含将字符写入的第一个单元格的屏幕缓冲区坐标。

【lpNumberOfCharsWritten】

指向接收实际写入屏幕缓冲区的字符数的变量。

返回值

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

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

备注

如果要写入的字符数超出屏幕缓冲区中指定行的结尾,则会将字符写入下一行。如果要写入的字符数超出屏幕缓冲区的结尾,字符将写入屏幕缓冲区的末尾。

写入位置的属性值不变。

Windows NT:此函数使用控制台当前代码页中的Unicode字符或8位字符。控制台的代码页最初默认为系统的OEM代码页。要更改控制台的代码页,请使用SetConsoleCPSetConsoleOutputCP功能,或使用CHCPskmode con cp select=命令。

也可以看看

COORD, FillConsoleOutputAttribute, SetConsoleCP, SetConsoleOutputCP, WriteConsoleOutputCharacter