Fungsi GetCharABCWidthsI (wingdi.h)

Artikel
08/27/2023

Fungsi GetCharABCWidthsI mengambil lebar, dalam unit logis, indeks glyph berturut-turut dalam rentang tertentu dari font TrueType saat ini. Fungsi ini hanya berhasil dengan font TrueType.

Sintaks

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

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] giFirst

Indeks glyph pertama dalam grup indeks glyph berturut-turut dari font saat ini. Parameter ini hanya digunakan jika parameter pgi adalah NULL.

[in] cgi

Jumlah indeks glyph.

[in] pgi

Penunjuk ke array yang berisi indeks glyph. Jika parameter ini NULL, parameter giFirst digunakan sebagai gantinya. Parameter cgi menentukan jumlah indeks glyph dalam array ini.

[out] pabc

Penunjuk ke array struktur ABC yang menerima lebar karakter, dalam unit logis. Array ini harus berisi setidaknya sebanyak struktur ABC karena ada indeks glyph yang ditentukan oleh parameter cgi .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Rasterizer TrueType menyediakan penspasian karakter ABC setelah ukuran titik tertentu dipilih. Spasi adalah jarak yang ditambahkan ke posisi saat ini sebelum menempatkan glyph. Spasi B adalah lebar bagian hitam dari glyph. Penspasian C adalah jarak yang ditambahkan ke posisi saat ini untuk memberikan spasi kosong di sebelah kanan glyph. Total lebar tingkat lanjut ditentukan oleh A+B+C.

Saat fungsi GetCharABCWidthsI mengambil lebar A atau C negatif untuk karakter, karakter tersebut menyertakan underhang atau overhang.

Untuk mengonversi lebar ABC ke unit desain font, aplikasi harus menggunakan nilai yang disimpan dalam anggota otmEMSquare dari struktur OUTLINETEXTMETRIC . Nilai ini dapat diambil dengan memanggil fungsi GetOutlineTextMetrics .

Lebar ABC dari karakter default digunakan untuk karakter di luar rentang font yang saat ini dipilih.

Untuk mengambil lebar indeks glyph dalam font non-TrueType, aplikasi harus menggunakan fungsi GetCharWidthI .

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll