IDWriteFontFace1：：GetKerningPairAdjustments 方法 (dwrite_1.h)

從字型的 kern 數據表擷取 kerning 字組調整。

語法

HRESULT GetKerningPairAdjustments(
        UINT32       glyphCount,
  [in]  UINT16 const *glyphIndices,
  [out] INT32        *glyphAdvanceAdjustments
);

參數

glyphCount

類型： UINT32

要擷取調整的字元數目。

[in] glyphIndices

類型： const UINT16*

要擷取調整的字元標識碼數位。

[out] glyphAdvanceAdjustments

類型： INT32*

每個圖像的字型設計單位所傳回的進階。 最後一個圖像調整為零。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

GetKerningPairAdjustments 不是直接取代 GDI 字元型 GetKerningPairs，但它會提供相同的角色，而不需要用戶端在本機快取它們。 GetKerningPairAdjustments 也會直接使用字元標識符，而不是 UCS-2 字元 (kern 數據表實際儲存它們的方式) ，以避免字元折疊和模棱兩可，例如虛線和連字元，或空格和非中斷空格。

較新的字型可能只有 GPOS Kerning，而不是舊版配對表格的 Kerning。 這類字型，例如 Gabriola，只會傳回 0 的調整。 GetKerningPairAdjustments 不會虛擬化這些 GPOS 專案，並將其扁平化成 Kerning 配對。

您可以呼叫 IDWriteFontFace1：：HasKerningPairs 來判斷是否需要呼叫 GetKerningPairAdjustments 來實現效能優勢。 如果您先前呼叫 IDWriteFontFace1：：HasKerningPairs 並傳回 FALSE，您可以避免呼叫 GetKerningPairAdjustments ，因為字型沒有 kerning 配對數據表專案。 也就是說，在此情況下， 呼叫 GetKerningPairAdjustments 會是無作業。

規格需求

需求	值
最低支援的用戶端	適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	dwrite_1.h
程式庫	Dwrite_1.lib
Dll	Dwrite_1.dll

另請參閱

IDWriteFontFace1

IDWriteFontFace1：：HasKerningPairs