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 |