GetKerningPairsA 函式 (wingdi.h)

GetKerningPairs函式會擷取指定裝置內容目前選取字型的字元 kerning 組。

語法

DWORD GetKerningPairsA(
  [in]  HDC           hdc,
  [in]  DWORD         nPairs,
  [out] LPKERNINGPAIR lpKernPair
);

[in] hdc

裝置內容的控制碼。

[in] nPairs

lpkrnpair陣列中的配對數目。如果字型有超過 nNumPairs kerning 組，則函式會傳回錯誤。

[out] lpKernPair

接收 kerning 配對之 KERNINGPAIR結構的陣列指標。陣列必須至少包含 nNumPairs 參數所指定的結構數目。如果此參數為 Null，函式會傳回字型的 Kerning 字組總數。

如果函式成功，則傳回值是傳回的 Kerning 配對數目。

如果此函式失敗，則傳回值為零。

注意

wingdi.h 標頭會將 GetKerningPairs 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。