Fungsi GetTextExtentPointI (wingdi.h)

Artikel
08/27/2023

Fungsi GetTextExtentPointI menghitung lebar dan tinggi array indeks glyph yang ditentukan.

Sintaks

BOOL GetTextExtentPointI(
  [in]  HDC    hdc,
  [in]  LPWORD pgiIn,
  [in]  int    cgi,
  [out] LPSIZE psize
);

Parameter

[in] hdc

Menangani konteks perangkat.

[in] pgiIn

Penunjuk ke array indeks glyph.

[in] cgi

Menentukan jumlah indeks glyph.

[out] psize

Penunjuk ke struktur SIZE yang menerima dimensi string, dalam unit logis.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Fungsi GetTextExtentPointI menggunakan font yang saat ini dipilih untuk menghitung dimensi array indeks glyph. Lebar dan tinggi, dalam unit logis, dihitung tanpa mempertimbangkan kliping apa pun.

Ketika fungsi ini mengembalikan tingkat teks, ia mengasumsikan bahwa teks horizontal, yaitu, bahwa escapement selalu 0. Ini berlaku untuk pengukuran teks horizontal dan vertikal. Bahkan jika Anda menggunakan font yang menentukan escapement bukan nol, fungsi ini tidak menggunakan sudut saat menghitung tingkat teks. Aplikasi harus mengonversinya secara eksplisit. Namun, ketika mode grafik diatur ke GM_ADVANCED dan orientasi karakter adalah 90 derajat dari orientasi cetak, nilai yang dikembalikan fungsi ini tidak mengikuti aturan ini. Ketika orientasi karakter dan orientasi cetak cocok untuk string tertentu, fungsi ini mengembalikan dimensi string dalam struktur SIZE sebagai { cx : 116, cy : 18 }. Ketika orientasi karakter dan orientasi cetak terpisah 90 derajat untuk string yang sama, fungsi ini mengembalikan dimensi string dalam struktur SIZE sebagai { cx : 18, cy : 116 }.

Karena beberapa karakter kern perangkat, jumlah jangkauan indeks glyph individu mungkin tidak sama dengan sejauh seluruh array indeks glyph.

Lebar string yang dihitung memperhitungkan spasi intercharacter yang ditetapkan oleh fungsi SetTextCharacterExtra .

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