Функция
FillConsoleOutputAttributeФункция
FillConsoleOutputAttribute устанавливает атрибуты символов для заданного числа символьных знакомест, начинающихся в заданных координатах в экранном буфере.Синтаксис
HANDLE hConsoleOutput, // дескриптор экранного буфера WORD wAttribute, // атрибуты цвета DWORD nLength, // число ячеек COORD dwWriteCoord, // первые координаты LPDWORD lpNumberOfAttrsWritten // число ячеек для записи ); |
Параметры
hConsoleOutput
Дескриптор экранного буфера консоли. Дескриптор должен иметь право доступа GENERIC_WRITE. Для получения дополнительной информации, см. статью Защита буфера и права доступа в консоли.
wAttribute
Присваивает атрибуты, которые используются при записи в экранный буфер консоли. Для получения дополнительной информации, см. статью Атрибуты символов.
Устанавливает атрибуты цвета текста и цвета фона для записи в экранный буфер. Может быть определена любая комбинация из ниже перечисленных значений:
FOREGROUND_BLUE |
| FOREGROUND_GREEN |
| FOREGROUND_RED |
| FOREGROUND_INTENSITY |
| BACKGROUND_BLUE |
| BACKGROUND_GREEN |
| BACKGROUND_RED |
| BACKGROUND_INTENSITY |
Например, нижеследующая комбинация значений пишет белый текст на черном фоне:
|
FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_BLUE |
nLength
Число символьных знакомест, в которые будут установлены заданные атрибуты цвета.
dwWriteCoord
Структура COORD, которая устанавливает координаты экранного буфера консоли первой ячейки, атрибуты которой должны быть установлены.
lpNumberOfAttrsWritten
Указатель на переменную, которая принимает число символьных знакомест, атрибуты которых были фактически установлены.
Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - не ноль.
Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Чтобы получить расширенные данные об ошибках, вызовите функцию GetLastError.
Замечания
Если число символьных знакомест, атрибуты которых должны быть установлены, продлевается за пределы заданной строки в экранном буфере консоли, устанавливаются ячейки следующей строки. Если число ячеек для записи к продлевается за пределы экранного буфера консоли, ячейки записываются до конца экранного буфера консоли.
Символьные значения в позициях записи не изменяются.
Пример кода
За примером обратитесь к статье Запись символов или цветов в последовательные ячейки.
Смотри также
Обзор консольных приложений, Функции консоли, COORD, FillConsoleOutputCharacter, SetConsoleTextAttribute, WriteConsoleOutputAttribute|
Размещение и совместимость FillConsoleOutputAttribute |
|
Windows. NET Server |
Да |
| Windows XP | Да |
|
Windows 2000 |
Да |
|
Windows NT |
Версия 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
Kernel32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Wincon.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |