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*
從成形產生的 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 |