Функция
FillConsoleOutputCharacterФункция
FillConsoleOutputCharacter записывает символ, начинающийся в заданных координатах в экранном буфере консоли, заданное число раз.Синтаксис
hConsoleOutput, // дескриптор экранного буфера TCHAR cCharacter, // символ DWORD nLength, // число ячеек COORD dwWriteCoord, // начальные координаты LPDWORD lpNumberOfCharsWritten // число ячеек для записи ); |
Параметры
hConsoleOutput
Дескриптор экранного буфера консоли. Дескриптор должен иметь право доступа
GENERIC_WRITE. Для получения дополнительной информации, см. статью Защита буфера и права доступа в консоли.cCharacter
Символ, который записывается в экранный буфер консоли.
nLength
Число символьных знакомест, в которых символ должен быть написан.
dwWriteCoord
Структура
COORD, которая устанавливает координаты первой ячейки экранного буфера консоли, в который символ должен быть написан.lpNumberOfCharsWritten
Указатель на переменную, которая принимает число символов, фактически записанных в экранный буфер консоли.
Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - не ноль.
Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Чтобы получать расширенные данные об ошибках, вызовите функцию
GetLastError.Замечания
Если число символов, которые записываются, продлевается за пределы конца заданной в экранном буфере консоли строки, символы записываются в следующей строке. Если число символов, которые записываются, продлевается за пределы конца экранного буфера консоли, символы записываются до конца экранного буфера консоли.
Значения атрибутов в позициях записи не изменяются.
Windows NT/2000/XP: Эта функция использует или символы
Unicode или 8-разрядные символы из текущей кодовой страницы консоли. По умолчанию изначальная кодовая страница консоли системная кодовая страница OEM. Чтобы изменить кодовую страницу консоли, используйте функции SetConsoleCP или SetConsoleOutputCP, или используйте команды chcp или mode con cp select=.Windows 95/98/Me:
Функция FillConsoleOutputCharacterW поддерживается Microsoft Layer for Unicode (Microsoft Планировщиком для Уникода). Чтобы использовать его, Вы должны добавить некоторые файлы к вашему приложению, как изложено в требованиях Microsoft Layer for Unicode для систем Windows 95/98/Me.Пример кода
За примером обратитесь к статье
Запись символов или цветов в последовательные ячейки.Смотри также
, Функции консоли, COORD, FillConsoleOutputAttribute, SetConsoleCP, SetConsoleOutputCP, WriteConsoleOutputCharacter
Размещение и совместимость FillConsoleOutputCharacter |
|
Windows. NET Server |
Да |
Windows XP | Да |
Windows 2000 |
Да |
Windows NT |
Версия 3.1 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Win32s |
Нет |
Используемая библиотека |
Kernel32.lib |
Заголовочный файл |
|
- объявлено в |
Wincon.h |
- включено в |
Windows.h |
Unicode |
Да |
Замечания по платформе |
Не имеется |