Baca dalam bahasa Inggris

Bagikan melalui

Fungsi GetTextExtentPointA (wingdi.h)

  • Artikel

Fungsi GetTextExtentPoint menghitung lebar dan tinggi string teks yang ditentukan.

Catatan Fungsi ini disediakan hanya untuk kompatibilitas dengan Windows versi 16-bit. Aplikasi harus memanggil fungsi GetTextExtentPoint32, yang memberikan hasil yang lebih akurat.
 

Sintaksis

BOOL GetTextExtentPointA(
  [in]  HDC    hdc,
  [in]  LPCSTR lpString,
  [in]  int    c,
  [out] LPSIZE lpsz
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] lpString

Penunjuk ke string yang menentukan teks. String tidak perlu dihentikan nol, karena cbString menentukan panjang string.

[in] c

Panjang string ditujukkan oleh lpString.

[out] lpsz

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

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Komentar

Fungsi GetTextExtentPoint menggunakan font yang saat ini dipilih untuk menghitung dimensi string. Lebar dan tinggi, dalam unit logis, dihitung tanpa mempertimbangkan kliping apa pun. Selain itu, fungsi ini mengasumsikan bahwa teks horizontal, yaitu, bahwa escapement selalu 0. Ini berlaku untuk pengukuran horizontal dan vertikal teks. Bahkan jika menggunakan font yang menentukan escapement bukan nol, fungsi ini tidak akan menggunakan sudut saat menghitung tingkat teks. Aplikasi harus mengonversinya secara eksplisit.

Karena beberapa karakter kern perangkat, jumlah sejauh mana karakter dalam string mungkin tidak sama dengan tingkat string.

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

Catatan

Header wingdi.h mendefinisikan GetTextExtentPoint sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Platform Target Windows
Header wingdi.h (termasuk Windows.h)
Pustaka Gdi32.lib
DLL Gdi32.dll

Lihat juga

Fungsi Font dan Teks

Font dan Gambaran Umum Teks

getTextExtentPoint32

UKURAN

SetTextCharacterExtra