Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".
Сайт рассылки: http://www.bcbdev.ru. Материалы по Win32 API, C++Builder.
Раздел "WinAPI": http://www.bcbdev.ru/winapi.htm
Раздел "C++Builder": http://www.bcbdev.ru/cbuilder.htm
Раздел "Примеры кода": http://www.bcbdev.ru/codesamples.htm
Раздел "MSDN по-русски": http://www.bcbdev.ru/msdn/index.php
Обновления на сайте
Нет.
Перевод
Сегодня вашему вниманию представлен перевод функции FillConsoleOutputAttribute.
FillConsoleOutputAttribute
Функция FillConsoleOutputAttribute устанавливает атрибуты символов для заданного
числа символьных знакомест, начинающихся в заданных координатах в экранном буфере.
BOOL FillConsoleOutputAttribute(
HANDLE hConsoleOutput, // дескриптор экранного буфера
WORD wAttribute, // атрибуты цвета
DWORD nLength, // число ячеек
COORD dwWriteCoord, // первые координаты
LPDWORD lpNumberOfAttrsWritten // число ячеек для записи
);
Параметры
hConsoleOutput
[in] Дескриптор экранного буфера консоли. Дескриптор должен иметь право доступа
GENERIC_WRITE. Для получения дополнительной информации, см. статью Защита буфера
и права доступа в консоли.
wAttribute
[in] Присваивает атрибуты, которые используются при записи в экранный буфер консоли.
Для получения дополнительной информации, см. статью Атрибуты символов. Устанавливает
атрибуты цвета текста и цвета фона для записи в экранный буфер. Может быть определена
любая комбинация из ниже перечисленных значений : FOREGROUND_BLUE, FOREGROUND_GREEN,
FOREGROUND_RED, FOREGROUND_INTENSITY, BACKGROUND_BLUE, BACKGROUND_GREEN, BACKGROUND_RED,
и BACKGROUND_INTENSITY. Например, нижеследующая комбинация значений пишет белый
текст на черном фоне:
FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_BLUE
nLength
[in] Число символьных знакомест, в которые будут установлены заданные атрибуты
цвета.
dwWriteCoord
[in] Структура COORD, которая устанавливает координаты экранного буфера консоли
первой ячейки, атрибуты которой должны быть установлены.
lpNumberOfAttrsWritten
[out] Указатель на переменную, которая принимает число символьных знакомест,
атрибуты которых были фактически установлены.
Возвращаемое значение
Если функция завершается успешно, величина возвращаемого значения - не ноль.
Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Чтобы
получать расширенные данные об ошибках, вызовите функцию GetLastError.
Примечания
Если число символьных знакомест, атрибуты которых должны быть установлены, продлевается
за пределы заданной строки в экранном буфере консоли, устанавливаются ячейки
следующей строки. Если число ячеек для записи к продлевается за пределы экранного
буфера консоли, ячейки записываются до конца экранного буфера консоли.
Символьные значения в позициях записи не изменяются .
За примером обратитесь к статье Запись символов или цветов в последовательные
ячейки.
Требования
Windows NT/2000 или более поздняя версия: Требуется Windows NT 3.1 или новее.
Windows 95/98/Me: Требуется Windows 95 или новее.
Заголовочный файл: Определено в Wincon.h; Подключать Windows.h.
Библиотека: Использовать Kernel32.lib.
Смотри также:
COORD, FillConsoleOutputCharacter, SetConsoleTextAttribute, WriteConsoleOutputAttribute
Справочник по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe
Справочник по WinAPI (zip-версия): http://www.bcbdev.ru/winapi/win32api.zip
Дружественная рассылка "Программирование на WinAPI": http://subscribe.ru/catalog/comp.soft.prog.russianmsdn
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@ua.fm