createFontIndirectExA 函数 (wingdi.h)

项目
08/27/2023

CreateFontIndirectEx 函数指定具有指定结构特征的逻辑字体。随后可以选择该字体作为任何设备上下文的当前字体。

语法

HFONT CreateFontIndirectExA(
  [in] const ENUMLOGFONTEXDVA *unnamedParam1
);

参数

[in] unnamedParam1

指向 ENUMLOGFONTEXDV 结构的指针，该结构定义多主控字体的特征。

请注意，此函数忽略 ENUMLOGFONTEXDV 中的 elfDesignVector 成员。

返回值

如果函数成功，则返回值是新 ENUMLOGFONTEXDV 结构的句柄。

如果函数失败，则返回值为零。没有可用的扩展错误信息。

注解

CreateFontIndirectEx 函数使用 ENUMLOGFONTEXDV 结构中指定的特征创建逻辑字体。使用 SelectObject 函数选择此字体时，GDI 的字体映射器会尝试将逻辑字体与现有物理字体匹配。如果找不到完全匹配项，则会提供一个替代项，其特征与请求的特征尽可能多地匹配。

如果不再需要该字体，请调用 DeleteObject 函数将其删除。

无论区域设置如何， CreateFont、 CreateFontIndirect和 CreateFontIndirectEx 的字体映射器都会识别英语和本地化的字样名称。

注意

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

要求

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