CONSOLE_FONT_INFOEX 结构

重要

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

包含控制台字体的扩展信息。

语法

typedef struct _CONSOLE_FONT_INFOEX {
  ULONG cbSize;
  DWORD nFont;
  COORD dwFontSize;
  UINT  FontFamily;
  UINT  FontWeight;
  WCHAR FaceName[LF_FACESIZE];
} CONSOLE_FONT_INFOEX, *PCONSOLE_FONT_INFOEX;

成员

cbSize
此结构的大小(以字节为单位)。 在调用 GetCurrentConsoleFontEx 之前,必须将此成员设置为 sizeof(CONSOLE_FONT_INFOEX),否则调用将失败。

nFont
系统控制台字体表中字体的索引。

dwFontSize
COORD 结构,包含字体中每个字符的宽度和高度(以逻辑单元为单位)。 X 成员包含宽度,而 Y 成员包含高度。

FontFamily
字体间距和系列。 有关此成员可能值的信息,请参阅 TEXTMETRIC 结构的 tmPitchAndFamily 成员的说明。

FontWeight
字体粗细。 粗细范围为 100 到 1000,按 100 的倍数表示。 例如,正常粗细为 400,而 700 为粗体。

FaceName
字样的名称(如 Courier 或 Arial)。

注解

若要获取字体大小,请将字体索引传递给 GetConsoleFontSize 函数。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 WinCon.h (include Windows.h)

另请参阅

GetCurrentConsoleFontEx