NEWTEXTMETRICA 结构 (wingdi.h)

NEWTEXTMETRIC 结构包含描述物理字体的数据。

语法

typedef struct tagNEWTEXTMETRICA {
  LONG  tmHeight;
  LONG  tmAscent;
  LONG  tmDescent;
  LONG  tmInternalLeading;
  LONG  tmExternalLeading;
  LONG  tmAveCharWidth;
  LONG  tmMaxCharWidth;
  LONG  tmWeight;
  LONG  tmOverhang;
  LONG  tmDigitizedAspectX;
  LONG  tmDigitizedAspectY;
  BYTE  tmFirstChar;
  BYTE  tmLastChar;
  BYTE  tmDefaultChar;
  BYTE  tmBreakChar;
  BYTE  tmItalic;
  BYTE  tmUnderlined;
  BYTE  tmStruckOut;
  BYTE  tmPitchAndFamily;
  BYTE  tmCharSet;
  DWORD ntmFlags;
  UINT  ntmSizeEM;
  UINT  ntmCellHeight;
  UINT  ntmAvgWidth;
} NEWTEXTMETRICA, *PNEWTEXTMETRICA, *NPNEWTEXTMETRICA, *LPNEWTEXTMETRICA;

成员

tmHeight

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

tmAscent

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

tmDescent

字符的下行(基线下方的单位)。

tmInternalLeading

tmHeight 成员设置的边界内的前导(空格)量。 重音标记和其他音调字符可能发生在此区域中。 设计器可将此成员设置为零。

tmExternalLeading

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

tmAveCharWidth

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

tmMaxCharWidth

字体中最宽字符的宽度。

tmWeight

字体的粗细。

tmOverhang

可以添加到某些合成字体的每个字符串的额外宽度。 合成某些属性(如粗体或斜体)时,图形设备接口(GDI)或设备可能必须基于每个字符和每字符串向字符串添加宽度。 例如,GDI 通过扩展每个字符的间距和偏移值过度,使字符串加粗;它通过剪切字符串来斜体字体。 在任一情况下,基本字符串都存在悬而未及的情况。 对于粗体字符串,悬置是超值偏移的距离。 对于斜体字符串,悬停是字体顶部在字体底部剪切的量。

tmOverhang 成员使应用程序能够确定由 GetTextExtentPoint32 函数调用对单个字符返回的字符宽度是多少是实际字符宽度以及每字符串的额外宽度。 实际宽度是盘区减去悬停。

tmDigitizedAspectX

为其设计字体的设备的水平方面。

tmDigitizedAspectY

为其设计字体的设备垂直方面。 tmDigitizedAspectXtmDigitizedAspectY 成员的比例是设计字体的设备纵横比。

tmFirstChar

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

tmLastChar

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

tmDefaultChar

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

tmBreakChar

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

tmItalic

斜体字体(如果为非零)。

tmUnderlined

非零的下划线字体。

tmStruckOut

非零字号的删除字体。

tmPitchAndFamily

所选字体的音调和系列。 低序位(位 0)指定字体的间距。 如果为 1,则字体是可变音调(或成比例)。 如果为 0,则字体是固定间距(或单空格)。 位 1 和 2 指定字体类型。 如果两位均为 0,则字体为光栅字体;如果位 1 为 1 且位 2 为 0,则字体为矢量字体;如果位 1 为 0 且位 2 已设置,或者两位均为 1,则字体是其他类型。 如果字体是设备字体,则位 3 为 1;否则为 0。

四个高序位指定字体系列。 tmPitchAndFamily 成员可以使用按位 AND 运算符与十六进制值0xF0组合,然后与相同匹配的字体系列名称进行比较。 有关字体系列的详细信息,请参阅 LOGFONT

tmCharSet

字体的字符集。

ntmFlags

指定字体是否为斜体、下划线、轮廓、粗体等。 可以是以下值的任何合理组合。

名字 意义
0 NTM_ITALIC 斜体的
5 NTM_BOLD 大胆
8 NTM_REGULAR 定期
16 NTM_NONNEGATIVE_AC 任何大小的字体中都没有字形有负 A 或 C 空格。
17 NTM_PS_OPENTYPE PostScript OpenType 字体
18 NTM_TT_OPENTYPE TrueType OpenType 字体
19 NTM_MULTIPLEMASTER 多个主字体
20 NTM_TYPE1 键入 1 字体
21 NTM_DSIG 具有数字签名的字体。 这允许可跟踪性并确保已测试字体且未损坏

ntmSizeEM

字体的 em 正方形的大小。 此值采用常规单位(即字体设计单位)。

ntmCellHeight

字体的高度(以表示单位为单位)。 此值应与 ntmSizeEM 成员的值进行比较。

ntmAvgWidth

字体中字符的平均宽度(以表示单位为单位)。 此值应与 ntmSizeEM 成员的值进行比较。

言论

TEXTMETRIC 结构中不包括 NEWTEXTMETRIC 结构的最后四个成员;在所有其他方面,结构都是相同的。

NEWTEXTMETRIC 结构中的 大小通常在逻辑单元中指定;也就是说,它们依赖于显示上下文的当前映射模式。

注意

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

要求

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

另请参阅

EnumFontFamilies

字体和文本结构

字体和文本概述

GetTextExtentPoint32

GetTextMetrics

LOGFONT