GetCharABCWidthsW 函式 (wingdi.h)

GetCharABCWidths 函式會從目前的 TrueType 字型擷取指定範圍中連續字元的寬度，以邏輯單位為單位。此函式只會以 TrueType 字型成功。

語法

BOOL GetCharABCWidthsW(
  [in]  HDC   hdc,
  [in]  UINT  wFirst,
  [in]  UINT  wLast,
  [out] LPABC lpABC
);

[in] hdc

裝置內容的控制碼。

[in] wFirst

目前字型中連續字元群組中的第一個字元。

[in] wLast

目前字型中連續字元群組中的最後一個字元。

[out] lpABC

以邏輯單元接收字元寬度的 ABC 結構陣列指標。此陣列必須包含至少數目 的 ABC 結構，因為 uFirstChar 和 uLastChar 參數所指定的範圍中有字元。

如果函式成功，則傳回值為非零

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

TrueType 點陣化程式會在選取特定點大小之後提供 ABC 字元間距。間距是放置圖像之前新增至目前位置的距離。 B 間距是圖像黑色部分的寬度。 C 間距是新增至目前位置的距離，以提供字元右邊的空白字元。總進階寬度是由 A+B+C 指定。

當 GetCharABCWidths 函式擷取字元的負 A 或 C 寬度時，該字元會包含下限或上方。

若要將 ABC 寬度轉換成字型設計單位，應用程式應該使用OUTLINETEXTMETRIC結構的otmEMSquare成員中所儲存的值。呼叫 GetOutlineTextMetrics 函式即可擷取此值。

預設字元的 ABC 寬度會用於目前選取字型範圍以外的字元。

若要擷取非 TrueType 字型中的字元寬度，應用程式應該使用 GetCharWidth 函式。

注意

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