CHAR_INFO 结构

  • 项目

重要

本文档介绍控制台平台功能，该功能已不再是生态系统蓝图的一部分。 我们不建议在新产品中使用此内容，但我们未来将无限期支持现有使用。 我们的首选最新解决方案侧重于虚拟终端序列，以实现跨平台方案中的最大兼容性。 可以在经典控制台与虚拟终端文档中找到有关此设计决策的详细信息。

指定 Unicode 或 ANSI 字符及其属性。 控制台函数使用此结构从控制台屏幕缓冲区读取和写入数据。

语法

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

成员

Char
由以下成员组成的联合。

UnicodeChar
屏幕缓冲区字符单元的 Unicode 字符。

AsciiChar
屏幕缓冲区字符单元的 ANSI 字符。

Attributes
字符属性。 此成员可以为零或以下值的任意组合。

值 含义
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 (include Windows.h)

另请参阅

ReadConsoleOutput

ScrollConsoleScreenBuffer

WriteConsoleOutput