Функция FillConsoleOutputAttribute

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

Синтаксис

BOOL 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

Нет

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

Не имеется

 

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

Hosted by uCoz