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
此方法返回时,包含一个指示字体文件类型的值。 请注意,即使 isSupportedFontType 为 FALSE, fontFileType 值也可能不同于 DWRITE_FONT_FILE_TYPE_UNKNOWN。
[out, optional] fontFaceType
此方法返回时,包含一个指示字体类型的值。 如果 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 |