CHAR_INFO 구조체

Important

이 문서에서는 더 이상 에코시스템 로드맵의 일부가 되지 않는 콘솔 플랫폼 기능에 대해 설명합니다. 이 콘텐츠를 신제품에서 사용하지 않는 것이 좋지만, 무기한 앞으로도 기존 사용을 계속 지원할 것입니다. 선호하는 최신 솔루션은 플랫폼 간 시나리오에서 최대 호환성을 위해 가상 터미널 시퀀스에 중점을 둡니다. 이 디자인 결정에 대한 자세한 내용은 클래식 콘솔과 가상 터미널 문서에서 확인할 수 있습니다.

유니코드 또는 ANSI 문자와 해당 특성을 지정합니다. 이 구조는 콘솔 함수에서 콘솔 화면 버퍼에서 읽고 쓰는 데 사용됩니다.

구문

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

멤버

Char
다음 멤버의 공용 구조체입니다.

UnicodeChar
화면 버퍼 문자 셀의 유니코드 문자입니다.

AsciiChar
화면 버퍼 문자 셀의 ANSI 문자입니다.

특성
문자 특성입니다. 이 멤버는 0이거나 다음 값의 조합일 수 있습니다.

값	의미
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	밑줄입니다.

예제

예를 들어 화면 버퍼의 내용 스크롤을 참조 하세요.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	WinCon.h(Windows.h 포함)

참고 항목

ReadConsoleOutput

ScrollConsoleScreenBuffer

WriteConsoleOutput