GetCharABCWidthsA 函式 (wingdi.h)

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

語法

BOOL GetCharABCWidthsA(
  [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 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll