Platform SDK: Files and I/O

CHAR_INFO

The CHAR_INFO structure specifies the Unicode or ANSI character and the foreground (text) and background color attributes of a screen buffer character cell. This structure is used by console functions to read from and write to a console screen buffer.

typedef struct _CHAR_INFO { 
  // Unicode or ANSI character
  union {
      WCHAR UnicodeChar; 
      CHAR AsciiChar; 
  } Char; 

  // Text and background colors
  WORD Attributes; 
} CHAR_INFO, *PCHAR_INFO; 

Members

Char
Specifies either the Unicode (wide-character) or ANSI character of a screen buffer character cell, depending on whether the Unicode or ANSI version of the function is used.
Attributes
Specifies the foreground (text) and background colors in which a screen buffer character cell is drawn. This member can be zero, or it can be any combination of the following values:

BACKGROUND_BLUE
FOREGROUND_BLUE
BACKGROUND_GREEN
FOREGROUND_GREEN
BACKGROUND_RED
FOREGROUND_RED
BACKGROUND_INTENSITY
FOREGROUND_INTENSITY

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Wincon.h; include Windows.h.

See Also

Consoles and Character-Mode Support Overview, Console Structures, ReadConsoleOutput, ScrollConsoleScreenBuffer, WriteConsoleOutput