Fungsi SetTextAlign (wingdi.h)

Artikel
08/27/2023

Fungsi SetTextAlign mengatur bendera perataan teks untuk konteks perangkat yang ditentukan.

Sintaks

UINT SetTextAlign(
  [in] HDC  hdc,
  [in] UINT align
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] align

Perataan teks dengan menggunakan masker nilai dalam daftar berikut. Hanya satu bendera yang dapat dipilih dari bendera yang memengaruhi perataan horizontal dan vertikal. Selain itu, hanya satu dari dua bendera yang mengubah posisi saat ini yang dapat dipilih.

Nilai	Makna
TA_BASELINE	Titik referensi akan berada di garis dasar teks.
TA_BOTTOM	Titik referensi akan berada di tepi bawah persegi panjang pembatas.
TA_TOP	Titik referensi akan berada di tepi atas persegi panjang pembatas.
TA_CENTER	Titik referensi akan diratakan secara horizontal dengan tengah persegi panjang pembatas.
TA_LEFT	Titik referensi akan berada di tepi kiri persegi panjang pembatas.
TA_RIGHT	Titik referensi akan berada di tepi kanan persegi panjang pembatas.
TA_NOUPDATECP	Posisi saat ini tidak diperbarui setelah setiap panggilan output teks. Titik referensi diteruskan ke fungsi output teks.
TA_RTLREADING	Windows edisi bahasa Timur Tengah: Teks ditata dalam urutan baca kanan ke kiri, dibandingkan dengan urutan default kiri ke kanan. Ini hanya berlaku ketika font yang dipilih ke dalam konteks perangkat adalah Ibrani atau Arab.
TA_UPDATECP	Posisi saat ini diperbarui setelah setiap panggilan output teks. Posisi saat ini digunakan sebagai titik referensi.

Ketika font saat ini memiliki garis dasar default vertikal, seperti halnya Kanji, nilai berikut harus digunakan alih-alih TA_BASELINE dan TA_CENTER.

Nilai	Makna
VTA_BASELINE	Titik referensi akan berada di garis dasar teks.
VTA_CENTER	Titik referensi akan diselaraskan secara vertikal dengan bagian tengah persegi panjang pembatas.

Nilai defaultnya adalah TA_LEFT, TA_TOP, dan TA_NOUPDATECP.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah pengaturan perataan teks sebelumnya.

Jika fungsi gagal, nilai yang dikembalikan GDI_ERROR.

Keterangan

Fungsi TextOut dan ExtTextOut menggunakan bendera perataan teks untuk memosisikan string teks pada tampilan atau perangkat lain. Bendera menentukan hubungan antara titik referensi dan persegi panjang yang mengikat teks. Titik referensi adalah posisi saat ini atau titik yang diteruskan ke fungsi output teks.

Persegi panjang yang mengikat teks dibentuk oleh sel karakter dalam string teks.

Cara terbaik untuk mendapatkan teks rata kiri adalah dengan menggunakan


SetTextAlign (hdc, GetTextAlign(hdc) & (~TA_CENTER))

atau


SetTextAlign (hdc,TA_LEFT | <other flags>)

Anda juga dapat menggunakan SetTextAlign (hdc, TA_LEFT) untuk tujuan ini, tetapi ini kehilangan pengaturan vertikal atau kanan-ke-kiri.

Catatan Anda tidak boleh menggunakan SetTextAlign dengan TA_UPDATECP saat Anda menggunakan ScriptStringOut, karena teks yang dipilih tidak dirender dengan benar. Jika Anda harus menggunakan bendera ini, Anda dapat membatalkan pengaturan dan mengatur ulang seperlunya untuk menghindari masalah.

Contoh

Misalnya, lihat Mengatur Perataan Teks.

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