Share via

IDWriteFontFile：：Analyze 方法 (dwrite.h)

  • 项目

分析文件并返回它是否表示字体，以及字体系统是否支持字体类型。

语法

HRESULT Analyze(
  [out]           BOOL                  *isSupportedFontType,
  [out]           DWRITE_FONT_FILE_TYPE *fontFileType,
  [out, optional] DWRITE_FONT_FACE_TYPE *fontFaceType,
  [out]           UINT32                *numberOfFaces
);

参数

[out] isSupportedFontType

类型： BOOL*

如果字体系统支持字体类型，则为 TRUE;否则为 FALSE。

[out] fontFileType

类型： DWRITE_FONT_FILE_TYPE*

此方法返回时，包含一个指示字体文件类型的值。 请注意，即使 isSupportedFontType 为 FALSE， fontFileType 值也可能不同于 DWRITE_FONT_FILE_TYPE_UNKNOWN。

[out, optional] fontFaceType

类型： DWRITE_FONT_FACE_TYPE*

此方法返回时，包含一个指示字体类型的值。 如果 fontFileType 不等于 DWRITE_FONT_FILE_TYPE_UNKNOWN，则可以从字体文件构造它。

[out] numberOfFaces

类型： UINT32*

此方法返回时，包含字体文件中包含的字体面数。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

备注

重要 某些字体文件类型可以识别，但字体系统不支持。 例如，字体系统将文件识别为类型 1 字体文件，但无法从中构造字体对象。 在这种情况下， Analyze 会将 isSupportedFontType 输出参数设置为 FALSE。
 

要求

   
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 dwrite.h
Library Dwrite.lib
DLL Dwrite.dll

请参阅

IDWriteFontFile