getCharWidthI 函式 (wingdi.h)

發行項
03/08/2023

GetCharWidthI函式會從目前字型擷取指定範圍中連續字元索引的寬度，以邏輯座標為單位。

語法

BOOL GetCharWidthI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPINT  piWidths
);

參數

[in] hdc

裝置內容的控制碼。

[in] giFirst

連續圖像索引群組中的第一個圖像索引。

[in] cgi

字元索引的數目。

[in] pgi

字元索引陣列的指標。如果此參數不是 Null，則會使用 ，而不是 giFirst 參數。

[out] piWidths

以邏輯座標接收寬度之緩衝區的指標。

傳回值

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

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

備註

如果pgi參數是Null，GetCharWidthI函式會處理連續圖像索引，並使用giFirst參數表示要處理的第一個圖像索引，以及指出要處理的字元索引數目的 cgi參數。否則 ，GetCharWidthI 函式會使用 cgi 參數來處理 pgi 參數所指向的字元索引陣列，指出要處理的字元索引數目。

如果目前字型中沒有字元，則會指派預設字元的寬度。

規格需求


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