Структура CHAR_INFO

  • Статья

Важно!

В этом документе описаны функции платформы консоли, которые больше не являются частью стратегии развития экосистемы. Мы не рекомендуем использовать это содержимое в новых продуктах, но мы будем продолжать поддерживать существующие использования для неопределенного будущего. Наше предпочтительное современное решение ориентировано на последовательности виртуальных терминалов для обеспечения максимальной совместимости в кроссплатформенных сценариях. Дополнительные сведения об этом решении по проектированию можно найти в классической консоли и в документе виртуального терминала .

Задает символ Юникода или ANSI и его атрибуты. Эта структура используется функциями консоли для чтения и записи в буфер экрана консоли.

Синтаксис

typedef struct _CHAR_INFO {
  union {
    WCHAR UnicodeChar;
    CHAR  AsciiChar;
  } Char;
  WORD  Attributes;
} CHAR_INFO, *PCHAR_INFO;

Участники

Char
Объединение следующих членов.

ЮникодChar
Символ Юникода ячейки символов буфера экрана.

AsciiChar
Символ ANSI ячейки буфера экрана.

Атрибуты
Атрибуты символов. Этот элемент может быть нулевым или любым сочетанием следующих значений.

Значение Значение
FOREGROUND_BLUE0x0001 Текст содержит синий цвет.
FOREGROUND_GREEN0x0002 Текст содержит зеленый цвет.
FOREGROUND_RED0x0004 Текст содержит красный цвет.
FOREGROUND_INTENSITY0x0008 Для цвета текста изменена интенсивность.
BACKGROUND_BLUE0x0010 Фон содержит синий цвет.
BACKGROUND_GREEN0x0020 Фон содержит зеленый цвет.
BACKGROUND_RED0x0040 Фон содержит красный цвет.
BACKGROUND_INTENSITY0x0080 Для цвета фона изменена интенсивность.
COMMON_LVB_LEADING_BYTE0x0100 Начальный байт.
COMMON_LVB_TRAILING_BYTE0x0200 Конечный байт.
COMMON_LVB_GRID_HORIZONTAL0x0400 Верхний горизонтальный.
COMMON_LVB_GRID_LVERTICAL0x0800 Левый вертикальный.
COMMON_LVB_GRID_RVERTICAL0x1000 Правый вертикальный.
COMMON_LVB_REVERSE_VIDEO0x4000 Обратный передний план и фоновый атрибут.
COMMON_LVB_UNDERSCORE0x8000 Знак подчеркивания.

Примеры

Пример см. в разделе "Прокрутка содержимого буфера экрана".

Requirements

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхний колонтитул WinCon.h (включая Windows.h)

См. также

ReadConsoleOutput

ScrollConsoleScreenBuffer

WriteConsoleOutput