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*

此方法返回时,包含一个指示字体文件类型的值。 请注意,即使 isSupportedFontTypeFALSEfontFileType 值也可能不同于 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