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代码页。要更改控制台的代码页,请使用SetConsoleCP或SetConsoleOutputCP功能,或使用CHCPsk或mode con cp select=命令。
也可以看看
COORD, FillConsoleOutputAttribute, SetConsoleCP, SetConsoleOutputCP, WriteConsoleOutputCharacter