Функция SetConsoleTextAttribute


Функция SetConsoleTextAttribute устанавливает атрибуты символов, записанных в экранный буфер консоли функцией WriteFile или WriteConsole, или повторенных в эхо режиме функцией ReadFile или ReadConsole. Эта функция воздействует на текст, записанный после вызова функции.

Синтаксис

BOOL SetConsoleTextAttribute(

HANDLE hConsoleOutput, // дескриптор экранного буфера
WORD
wAttributes       // цвет текста и фона

);

Параметры

hConsoleOutput

[in] Дескриптор экранного буфера консоли. Дескриптор должен иметь право доступа GENERIC_READ. Для получения дополнительной информации, см. статью Защита буфера и права доступа в консоли.

wAttributes

[in] Смотри Атрибуты символа.

Возвращаемые значения

Если функция завершается успешно, величина возвращаемого значения - не ноль.

Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Чтобы получать расширенные данные об ошибках, вызовите функцию GetLastError.

Замечания

Чтобы выяснять текущие атрибуты цвета экранного буфера, вызовите функцию GetConsoleScreenBufferInfo.

Код примера

Пример смотри в статье Использование высокоуровневых функций ввода и вывода данных.

Смотри также

Обзор консольных приложений, Функции консоли, GetConsoleScreenBufferInfo, ReadConsole, ReadFile, WriteConsole, WriteFile

Размещение и совместимость SetConsoleTextAttribute

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Kernel32.lib

Заголовочный файл

 

- объявлено в

Wincon.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz