IDWriteTextAnalyzer1::GetJustificationOpportunities 方法 (dwrite_1.h)
检索给定文本和整形字形属性的每个字形的对齐机会信息。
语法
HRESULT GetJustificationOpportunities(
IDWriteFontFace *fontFace,
FLOAT fontEmSize,
DWRITE_SCRIPT_ANALYSIS scriptAnalysis,
UINT32 textLength,
UINT32 glyphCount,
[in] WCHAR const *textString,
[in] UINT16 const *clusterMap,
[in] DWRITE_SHAPING_GLYPH_PROPERTIES const *glyphProperties,
[out] DWRITE_JUSTIFICATION_OPPORTUNITY *justificationOpportunities
);
参数
fontFace
类型: IDWriteFontFace*
用于塑造的字体。 这主要对于返回 kashida 宽度的正确结果非常重要。
可以为 NULL。
fontEmSize
类型: FLOAT
用于字形运行的字体 em 大小。
scriptAnalysis
项化器中文本的脚本。
textLength
类型: UINT32
文本的长度。
glyphCount
类型: UINT32
字形数。
[in] textString
类型: const WCHAR*
用于生成字形的字符。
[in] clusterMap
类型: const UINT16*
通过整形生成的群集映射。
[in] glyphProperties
类型: const DWRITE_SHAPING_GLYPH_PROPERTIES*
通过整形生成的字形属性。
[out] justificationOpportunities
类型: DWRITE_JUSTIFICATION_OPPORTUNITY*
指向 DWRITE_JUSTIFICATION_OPPORTUNITY 结构的指针,该结构接收每个字形允许的理由扩展/压缩的信息。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
备注
此函数在通过 IDWriteTextAnalyzer::GetGlyphs 方法完成整形后,按运行调用。
请注意, 此函数仅支持 (DWRITE_MEASURING_MODE_NATURAL) 的自然指标。
要求
最低受支持的客户端 | 适用于 Windows 7 的 Windows 8 和平台更新 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2012 和适用于 Windows Server 2008 R2 的平台更新 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | dwrite_1.h |
Library | Dwrite_1.lib |
DLL | Dwrite_1.dll |