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

类型： DWRITE_SCRIPT_ANALYSIS

项化器中文本的脚本。

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

请参阅

IDWriteTextAnalyzer1