Fungsi SetTextJustification (wingdi.h)

Artikel
08/27/2023

Fungsi SetTextJustification menentukan jumlah ruang yang harus ditambahkan sistem ke karakter pemisah dalam string teks. Ruang ditambahkan saat aplikasi memanggil fungsi TextOut atau ExtTextOut .

Sintaks

BOOL SetTextJustification(
  [in] HDC hdc,
  [in] int extra,
  [in] int count
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] extra

Total ruang ekstra, dalam unit logis, untuk ditambahkan ke baris teks. Jika mode pemetaan saat ini tidak MM_TEXT, nilai yang diidentifikasi oleh parameter nBreakExtra diubah dan dibulatkan ke piksel terdekat.

[in] count

Jumlah karakter pemisah dalam baris.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Karakter pemisah biasanya merupakan karakter spasi (ASCII 32), tetapi dapat didefinisikan oleh font sebagai beberapa karakter lainnya. Fungsi GetTextMetrics dapat digunakan untuk mengambil karakter pemisah font.

Fungsi TextOut mendistribusikan ruang ekstra yang ditentukan secara merata di antara karakter pemisah dalam baris.

Fungsi GetTextExtentPoint32 selalu digunakan dengan fungsi SetTextJustification . Terkadang fungsi GetTextExtentPoint32 memperhitungkan justifikasi saat menghitung lebar baris yang ditentukan sebelum pembenaran, dan terkadang tidak. Untuk detail selengkapnya tentang ini, lihat GetTextExtentPoint32. Lebar ini harus diketahui sebelum nilai nBreakExtra yang sesuai dapat dihitung.

SetTextJustification dapat digunakan untuk membenarkan baris yang berisi beberapa string dalam font yang berbeda. Dalam hal ini, setiap string harus dibenarkan secara terpisah.

Karena kesalahan pembulatan dapat terjadi selama pembenaran, sistem menyimpan istilah kesalahan yang berjalan yang menentukan nilai kesalahan saat ini. Saat membenarkan baris yang berisi beberapa eksekusi, GetTextExtentPoint secara otomatis menggunakan istilah kesalahan ini ketika menghitung sejauh mana eksekusi berikutnya, memungkinkan TextOut untuk memadukan kesalahan ke dalam proses baru. Setelah setiap baris dibenarkan, istilah kesalahan ini harus dibersihkan untuk mencegahnya dimasukkan ke baris berikutnya. Istilah dapat dibersihkan dengan memanggil SetTextJustification dengan nBreakExtra diatur ke nol.

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