WriteConsoleOutputCharacter函数将从指定位置开始,将多个字符复制到控制台屏幕缓冲区的连续单元格。
BOOL WriteConsoleOutputCharacter(
HANDLE 【hConsoleOutput】, | //处理控制台屏幕缓冲区 |
LPCTSTR 【lpCharacter】, | //指向缓冲区的指针写入字符 |
DWORD 【nLength】, | //要写入的字符单元格数 |
COORD 【dwWriteCoord】, | //要写入的第一个单元格的坐标 |
LPDWORD 【lpNumberOfCharsWritten】 | //指向写入的单元格数的指针 |
); |
参数
【hConsoleOutput】
标识屏幕缓冲区。句柄必须具有GENERIC_WRITE权限。
【lpCharacter】
指向包含要写入屏幕缓冲区的字符的缓冲区。
【nLength】
指定要写入的屏幕缓冲区字符单元的数量。
【dwWriteCoord】
指定要写入的屏幕缓冲区中第一个单元格的列和行坐标。
【lpNumberOfCharsWritten】
指向接收实际写入的字符数的32位变量。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
如果要写入的字符数超出屏幕缓冲区中指定行的结尾,则会将字符写入下一行。如果要写入的字符数超出屏幕缓冲区的结尾,字符将写入屏幕缓冲区的末尾。
写入位置的属性值不变。
Windows NT:此函数使用控制台当前代码页中的Unicode字符或8位字符。控制台的代码页最初默认为系统的OEM代码页。要更改控制台的代码页,请使用SetConsoleCP或SetConsoleOutputCP功能,或使用CHCPsk或mode con cp select=命令。
也可以看看
ReadConsoleOutput, ReadConsoleOutputAttribute, ReadConsoleOutputCharacter, SetConsoleCP, SetConsoleOutputCP, WriteConsoleOutput, WriteConsoleOutputAttribute