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*

從成形產生的 Clustermap。

[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 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	dwrite_1.h
程式庫	Dwrite_1.lib
Dll	Dwrite_1.dll

另請參閱

IDWriteTextAnalyzer1