Прочитать на английском

Поделиться через


Структура CHAR_INFO

Важно!

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

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

Синтаксис

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

Участники

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

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

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

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

Значение Значение
FOREGROUND_BLUE 0x0001 Текст содержит синий цвет.
FOREGROUND_GREEN 0x0002 Текст содержит зеленый цвет.
FOREGROUND_RED 0x0004 Текст содержит красный цвет.
FOREGROUND_INTENSITY 0x0008 Для цвета текста изменена интенсивность.
BACKGROUND_BLUE 0x0010 Фон содержит синий цвет.
BACKGROUND_GREEN 0x0020 Фон содержит зеленый цвет.
BACKGROUND_RED 0x0040 Фон содержит красный цвет.
BACKGROUND_INTENSITY 0x0080 Для цвета фона изменена интенсивность.
COMMON_LVB_LEADING_BYTE 0x0100 Начальный байт.
COMMON_LVB_TRAILING_BYTE 0x0200 Конечный байт.
COMMON_LVB_GRID_HORIZONTAL 0x0400 Верхний горизонтальный.
COMMON_LVB_GRID_LVERTICAL 0x0800 Левый вертикальный.
COMMON_LVB_GRID_RVERTICAL 0x1000 Правый вертикальный.
COMMON_LVB_REVERSE_VIDEO 0x4000 Обратный передний план и фоновый атрибут.
COMMON_LVB_UNDERSCORE 0x8000 Знак подчеркивания.

Примеры

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

Требования

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

См. также

ReadConsoleOutput

ScrollConsoleScreenBuffer

WriteConsoleOutput