|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| kernel32.lib
| Header File
| wincon.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
WriteConsoleOutputCharacter
The WriteConsoleOutputCharacter function copies a number of characters to consecutive cells of a console
screen buffer, beginning at a specified location.
BOOL WriteConsoleOutputCharacter(
HANDLE hConsoleOutput,
| // handle to a console screen buffer
| LPCTSTR lpCharacter,
| // pointer to buffer to write characters from
| DWORD nLength,
| // number of character cells to write to
| COORD dwWriteCoord,
| // coordinates of first cell to write to
| LPDWORD lpNumberOfCharsWritten
| // pointer to number of cells written to
| );
|
|
Parameters
hConsoleOutput
Identifies the screen buffer. The handle must have GENERIC_WRITE access.
lpCharacter
Points to a buffer that contains the characters to write to the screen buffer.
nLength
Specifies the number of screen buffer character cells to write to.
dwWriteCoord
Specifies the column and row coordinates of the first cell in the screen
buffer to write to.
lpNumberOfCharsWritten
Points to a 32-bit variable that receives the number of characters actually
written.
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error
information, call GetLastError.
Remarks
If the number of characters to be written to extends beyond the end of the
specified row in the screen buffer, characters are written to the next row. If the
number of characters to be written to extends beyond the end of the screen
buffer, characters are written up to the end of the screen buffer.
The attribute values at the positions written to are not changed.
Windows NT: This function uses either Unicode characters or 8-bit characters from the
console's current codepage. The console's codepage defaults initially to the
system's OEM codepage. To change the console's codepage, use the SetConsoleCP or SetConsoleOutputCP functions, or use the chcp or mode con cp select= commands.
See Also
ReadConsoleOutput, ReadConsoleOutputAttribute, ReadConsoleOutputCharacter, SetConsoleCP, SetConsoleOutputCP, WriteConsoleOutput, WriteConsoleOutputAttribute
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
