Функция FillConsoleOutputCharacter

Функция FillConsoleOutputCharacter записывает символ, начинающийся в заданных координатах в экранном буфере консоли, заданное число раз.

Синтаксис

BOOL FillConsoleOutputCharacter(

HANDLE 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

Да

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz