getCharABCWidthsI 函式 (wingdi.h)

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

語法

BOOL GetCharABCWidthsI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPABC  pabc
);

[in] hdc

裝置內容的控制碼。

[in] giFirst

目前字型中連續字元索引群組中的第一個圖像索引。只有當 pgi 參數為 Null時，才會使用此參數。

[in] cgi

字元索引的數目。

[in] pgi

包含字元索引之陣列的指標。如果此參數為 Null，則會改用 giFirst 參數。 cgi參數會指定此陣列中的字元索引數目。

[out] pabc

以邏輯單位接收字元寬度之 ABC 結構的陣列指標。此陣列至少必須包含Cgi參數所指定的字元索引數目至少一樣多的ABC結構。

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

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

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

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

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

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

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


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