Fungsi SetTextCharacterExtra (wingdi.h)

Fungsi SetTextCharacterExtra mengatur penspasian intercharacter. Penspasian intercharacter ditambahkan ke setiap karakter, termasuk karakter pemisah, saat sistem menulis baris teks.

Sintaks

int SetTextCharacterExtra(
  [in] HDC hdc,
  [in] int extra
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] extra

Jumlah ruang ekstra, dalam unit logis, yang akan ditambahkan ke setiap karakter. Jika mode pemetaan saat ini tidak MM_TEXT, parameter nCharExtra diubah dan dibulatkan ke piksel terdekat.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah spasi intercharacter sebelumnya.

Jika fungsi gagal, nilai yang dikembalikan 0x80000000.

Keterangan

Fungsi ini didukung terutama untuk kompatibilitas dengan aplikasi yang ada. Aplikasi baru umumnya harus menghindari panggilan fungsi ini, karena tidak kompatibel dengan skrip kompleks (skrip yang memerlukan pembentukan teks; Skrip Arab adalah contoh dari ini).

Pendekatan yang disarankan adalah bahwa alih-alih memanggil fungsi ini dan kemudian TextOut, aplikasi harus memanggil ExtTextOut dan menggunakan parameter lpDx-nya untuk memasok lebar.

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

DrawText

Fungsi Font dan Teks

Gambaran Umum Font dan Teks

GetTextCharacterExtra

TextOut