LOGFONTA 结构 （shtypes.h）

定义字体的属性。

Syntax

typedef struct tagLOGFONTA {
  LONG lfHeight;
  LONG lfWidth;
  LONG lfEscapement;
  LONG lfOrientation;
  LONG lfWeight;
  BYTE lfItalic;
  BYTE lfUnderline;
  BYTE lfStrikeOut;
  BYTE lfCharSet;
  BYTE lfOutPrecision;
  BYTE lfClipPrecision;
  BYTE lfQuality;
  BYTE lfPitchAndFamily;
  CHAR lfFaceName[32];
} LOGFONTA;

Members

lfHeight

类型： LONG

指定字体字符单元格或字符的高度（以逻辑单位为单位）。 字符高度值（也称为 em 高度）是字符单元格高度值减去内部前导值。 字体映射器按以下方式解释 lfHeight 中指定的值。

对于所有高度比较，字体映射器查找不超过所请求大小的最大字体。

首次使用字体时，会发生此映射。

对于MM_TEXT映射模式，可以使用以下公式为具有给定点大小的字体指定高度。

lfHeight = -MulDiv(PointSize, GetDeviceCaps(hDC, LOGPIXELSY), 72);

其中 MulDiv 的定义如下：

#define MulDiv(a,b,c)    (((a)*(b))/(c))

lfWidth

类型： LONG

指定字体中字符的平均宽度（以逻辑单位为单位）。 如果 lfWidth 不为零，则设备纵横比与可用字体的数字化纵横比匹配，以查找最接近的匹配，由差值的绝对值确定。

lfEscapement

类型： LONG

指定转义向量与设备的 x 轴之间的角度（以十分之几度为单位）。 转义向量与文本行的基线并行。

lfEscapement 成员同时指定转义和方向。 应将 lfEscapement 和 lfOrientation 设置为相同的值。

lfOrientation

类型： LONG

指定每个字符的底线与设备的 x 轴之间的角度（以十分之几度为单位）。

lfWeight

类型： LONG

指定 0 到 1000 范围内的字体粗细。 例如，400 正常，700 为粗体。 如果此值为零，则使用默认权重。

为了方便起见，Wingdi.h 中定义了以下值。

lfItalic

类型： BYTE

若要 指定斜体字体，则为 TRUE。

lfUnderline

类型： BYTE

若要 指定带下划线的字体，则为 TRUE。

lfStrikeOut

类型： BYTE

若要 指定删除线字体，则为 TRUE。

lfCharSet

类型： BYTE

指定字符集。 以下值是预定义的：

作系统中可能存在具有其他字符集的字体。 如果应用程序使用具有未知字符集的字体，则不应尝试翻译或解释使用该字体呈现的字符串。

此成员在字体映射过程中非常重要。 若要确保结果一致，请指定特定的字符集。 如果在 lfFaceName 成员中指定字号名称，请确保 lfCharSet 值与 lfFaceName 中指定的字样字符集匹配。

lfOutPrecision

类型： BYTE

指定输出精度。 输出精度定义输出必须与所请求字体的高度、宽度、字符方向、转义、间距和字体类型相匹配的方式。 它可以是 Wingdi.h 中定义的以下值之一：

lfClipPrecision

类型： BYTE

指定剪辑精度。 剪辑精度定义如何剪辑部分超出剪辑区域的字符。 它可以是 Wingdi.h 中定义的以下一个或多个值：

lfQuality

类型： BYTE

指定输出质量。 输出质量定义 GDI 必须尝试将逻辑字体属性与实际物理字体属性匹配的方式。 它可以是 Wingdi.h 中定义的以下值之一：

lfPitchAndFamily

类型： BYTE

指定字体的间距和组。 两个低序位指定字体的间距，可以是 Wingdi.h 中定义的以下值之一：

• DEFAULT_PITCH
• FIXED_PITCH
• MONO_FONT
• VARIABLE_PITCH

• FF_DECORATIVE
• FF_DONTCARE
• FF_MODERN
• FF_ROMAN
• FF_SCRIPT
• FF_SWISS

字体系列以一般方式描述字体的外观。 当确切的字样不可用时，它们用于指定字体。 字体系列的值如下所示：

lfFaceName[32]

类型： TCHAR[LF_FACESIZE]

指定以 null 结尾的字符串，该字符串指定字体的字样名称。 此字符串的长度不得超过 32 个字符，包括终止 null 字符。 EnumFontFamilies 函数可用于枚举所有当前可用的字体的字样名称。 如果 lfFaceName 是空字符串，GDI 将使用与其他指定属性匹配的第一个字体。

注解

以下情况不支持 ClearType 反锯齿：

• 文本在打印机上呈现。
• 为 256 种颜色或更少颜色设置的显示。
• 文本呈现到终端服务器客户端。
• 字体不是 TrueType 字体，也不是具有 TrueType 轮廓的 Microsoft OpenType 字体。 例如，以下不支持 ClearType 抗锯齿：类型 1 字体、Postscript OpenType 字体（不含 TrueType 轮廓、位图字体、矢量字体和设备字体）。
• 该字体已针对包含嵌入位图的任何字号调整嵌入位图。 例如，这通常发生在东亚字体中。

要求

另请参阅

IVisualProperties：：GetFont

IVisualProperties：：SetFont