textMETRICW 结构 (wingdi.h)

项目
08/27/2023

TEXTMETRIC 结构包含有关物理字体的基本信息。所有大小都以逻辑单元指定;也就是说，它们依赖于显示上下文的当前映射模式。

语法

typedef struct tagTEXTMETRICW {
  LONG  tmHeight;
  LONG  tmAscent;
  LONG  tmDescent;
  LONG  tmInternalLeading;
  LONG  tmExternalLeading;
  LONG  tmAveCharWidth;
  LONG  tmMaxCharWidth;
  LONG  tmWeight;
  LONG  tmOverhang;
  LONG  tmDigitizedAspectX;
  LONG  tmDigitizedAspectY;
  WCHAR tmFirstChar;
  WCHAR tmLastChar;
  WCHAR tmDefaultChar;
  WCHAR tmBreakChar;
  BYTE  tmItalic;
  BYTE  tmUnderlined;
  BYTE  tmStruckOut;
  BYTE  tmPitchAndFamily;
  BYTE  tmCharSet;
} TEXTMETRICW, *PTEXTMETRICW, *NPTEXTMETRICW, *LPTEXTMETRICW;

成员

tmHeight

字符的高度 (上升 + 下降) 。

tmAscent

升 (基线上方的单位) 字符。

tmDescent

字符) 基线以下的下降 (单位。

tmInternalLeading

tmHeight 成员设置的边界内) 前导 (空间量。此区域中可能会出现重音符号和其他音调符号。设计器可将此成员设置为零。

tmExternalLeading

应用程序在行之间添加的额外前导 (空间量) 。由于此区域在字体外部，因此它不包含任何标记，并且不会在 OPAQUE 或 TRANSPARENT 模式下被文本输出调用更改。设计器可将此成员设置为零。

tmAveCharWidth

字体中字符的平均宽度 (通常定义为字母 x ) 的宽度。此值不包括粗体或斜体字符所需的悬垂。

tmMaxCharWidth

该字体中最宽字符的宽度。

tmWeight

该字体的粗细。

tmOverhang

可能添加到一些合成字体中的每个字符串的附加宽度。合成某些属性（如粗体或斜体）时，图形设备接口 (GDI) 或设备可能需要同时按字符和按字符串添加宽度。例如，GDI 通过展开每个字符的间距并用偏移值进行过度调整，使字符串加粗;它通过剪切字符串来斜体字体。在任一情况下，基本字符串都存在悬垂。对于粗体字符串，悬空是过度打击偏移的距离。对于斜体字符串，悬垂是字体顶部从字体底部剪切的量。

tmOverhang 成员使应用程序能够确定 GetTextExtentPoint32 函数调用对单个字符返回的字符宽度是多少是实际字符宽度，以及每字符串多余宽度多少。实际宽度是范围减去悬垂。

tmDigitizedAspectX

该字体的目标设备的水平比例。

tmDigitizedAspectY

该字体的目标设备的垂直比例。 tmDigitizedAspectX 和 tmDigitizedAspectY 成员的比率是为其设计字体的设备纵横比。

tmFirstChar

字体中定义的第一个字符的值。

tmLastChar

字体中定义的最后一个字符的值。

tmDefaultChar

要替换为不在字体中的字符的字符的值。

tmBreakChar

将用于定义文本对齐的分词符的字符的值。

tmItalic

如果为非零，则指定斜体字体。

tmUnderlined

指定带下划线的字体（如果为非零）。

tmStruckOut

如果为非零，则为删除线字体。

tmPitchAndFamily

指定有关实际字体的间距、技术和系列的信息。

此成员的四个低位指定有关字体的间距和技术的信息。为四个位中的每个位定义了一个常量。

返回的常量	含义
TMPF_FIXED_PITCH	如果设置了此位，则字体为可变间距字体。如果清除此位，则字体是固定的间距字体。请仔细注意，这些含义与常量名称的含义相反。
TMPF_VECTOR	如果设置了此位，则字体为矢量字体。
TMPF_TRUETYPE	如果设置了此位，则字体为 TrueType 字体。
TMPF_DEVICE	如果设置了此位，则字体为设备字体。

应用程序应仔细测试以这些低阶位编码的质量，不要做出任意假设。例如，除了设置自己的位外，TrueType 和 PostScript 字体还设置TMPF_VECTOR位。单空间位图字体清除所有这些低序位;比例位图字体设置TMPF_FIXED_PITCH位。 Postscript 打印机设备字体设置TMPF_DEVICE、TMPF_VECTOR和TMPF_FIXED_PITCH位。

tmPitchAndFamily 的四个高阶位指定字体的字体系列。应用程序可以使用值0xF0和按位 AND 运算符来屏蔽 tmPitchAndFamily 的四个低阶位，从而获得一个值，该值可以直接与字体系列名称进行比较，以查找相同的匹配项。有关字体系列的信息，请参阅 LOGFONT 结构的说明。

tmCharSet

字体的字符集。字符集可以是以下值之一。

ANSI_CHARSET
BALTIC_CHARSET
CHINESEBIG5_CHARSET
DEFAULT_CHARSET
EASTEUROPE_CHARSET
GB2312_CHARSET
GREEK_CHARSET
HANGUL_CHARSET
MAC_CHARSET
OEM_CHARSET
RUSSIAN_CHARSET
SHIFTJIS_CHARSET
SYMBOL_CHARSET
TURKISH_CHARSET
VIETNAMESE_CHARSET

Windows 的朝鲜语版本：

JOHAB_CHARSET

Windows 中东语言版本：

ARABIC_CHARSET
HEBREW_CHARSET

Windows 的泰语版本：

THAI_CHARSET

注解

注意

wingdi.h 标头将 TEXTMETRIC 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	wingdi.h (包括 Windows.h)

另请参阅

通过

textMETRICW 结构 (wingdi.h)

语法

成员

注解

要求

另请参阅

反馈

其他资源