Fungsi GetTextExtentExPointI (wingdi.h)

Fungsi GetTextExtentExPointI mengambil jumlah karakter dalam string tertentu yang akan pas dalam ruang tertentu dan mengisi array dengan tingkat teks untuk masing-masing karakter tersebut. (Tingkat teks adalah jarak antara awal spasi dan karakter yang akan pas di spasi.) Informasi ini berguna untuk perhitungan pembungkus kata.

Sintaks

BOOL GetTextExtentExPointI(
  [in]  HDC    hdc,
  [in]  LPWORD lpwszString,
  [in]  int    cwchString,
  [in]  int    nMaxExtent,
  [out] LPINT  lpnFit,
  [out] LPINT  lpnDx,
  [out] LPSIZE lpSize
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] lpwszString

Penunjuk ke array indeks glyph yang jangkauannya akan diambil.

[in] cwchString

Jumlah glyph dalam array yang ditujukkan oleh parameter pgiIn .

[in] nMaxExtent

Lebar maksimum yang diperbolehkan, dalam unit logis, dari string yang diformat.

[out] lpnFit

Penunjuk ke bilangan bulat yang menerima hitungan jumlah maksimum karakter yang akan pas dalam spasi yang ditentukan oleh parameter nMaxExtent . Ketika parameter lpnFit adalah NULL, parameter nMaxExtent diabaikan.

[out] lpnDx

Penunjuk ke array bilangan bulat yang menerima batas glyph parsial. Setiap elemen dalam array memberikan jarak, dalam unit logis, antara awal array indeks glyph dan salah satu glyph yang cocok dalam ruang yang ditentukan oleh parameter nMaxExtent . Meskipun array ini harus memiliki setidaknya sebanyak indeks glyph yang ditentukan oleh parameter cgi , fungsi mengisi array dengan luas hanya untuk indeks glyph sebanyak yang ditentukan oleh parameter lpnFit . Jika lpnFitNULL, fungsi tidak menghitung lebar string parsial.

[out] lpSize

Penunjuk ke struktur SIZE yang menerima dimensi array indeks glyph, dalam unit logis. Nilai ini tidak boleh NULL.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Jika parameter lpnFit dan alpDxNULL, memanggil fungsi GetTextExtentExPointI setara dengan memanggil fungsi GetTextExtentPointI .

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 }.

Persyaratan

Persyaratan	Nilai
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

Lihat juga

Fungsi Font dan Teks

Gambaran Umum Font dan Teks

GetTextExtentPoint

UKURAN