Fungsi GetTextAlign (wingdi.h)

Artikel
03/13/2024

Fungsi GetTextAlign mengambil pengaturan perataan teks untuk konteks perangkat yang ditentukan.

Sintaks

UINT GetTextAlign(
  [in] HDC hdc
);

Parameter

[in] hdc

Handel ke konteks perangkat.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah status bendera perataan teks. Untuk informasi selengkapnya tentang nilai yang dikembalikan, lihat bagian Keterangan. Nilai yang dikembalikan adalah kombinasi dari nilai berikut.

Nilai	Makna
TA_BASELINE	Titik referensi berada di garis dasar teks.
TA_BOTTOM	Titik referensi berada di tepi bawah persegi panjang pembatas.
TA_TOP	Titik referensi berada di tepi atas persegi panjang pembatas.
TA_CENTER	Titik referensi diratakan secara horizontal dengan tengah persegi panjang pembatas.
TA_LEFT	Titik referensi berada di tepi kiri persegi panjang pembatas.
TA_RIGHT	Titik referensi berada di tepi kanan persegi panjang pembatas.
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_NOUPDATECP	Posisi saat ini tidak diperbarui setelah setiap panggilan output teks.
TA_UPDATECP	Posisi saat ini diperbarui setelah setiap panggilan output teks.

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

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

Jika fungsi gagal, nilai yang dikembalikan adalah GDI_ERROR.

Keterangan

Persegi panjang pembatas adalah persegi panjang yang menghubungkan semua sel karakter dalam string teks. Dimensinya dapat diperoleh dengan memanggil fungsi GetTextExtentPoint32 .

Bendera perataan teks menentukan bagaimana fungsi TextOut dan ExtTextOut meratakan string teks sehubungan dengan titik referensi string yang disediakan untuk TextOut atau ExtTextOut.

Bendera perataan teks belum tentu bendera bit tunggal dan mungkin sama dengan nol. Bendera harus diperiksa dalam grup bendera terkait, seperti yang ditunjukkan dalam daftar berikut.

TA_LEFT, TA_RIGHT, dan TA_CENTER
TA_BOTTOM, TA_TOP, dan TA_BASELINE
TA_NOUPDATECP dan TA_UPDATECP

Jika font saat ini memiliki garis dasar default vertikal, bendera terkait seperti yang diperlihatkan dalam daftar berikut.

TA_LEFT, TA_RIGHT, dan VTA_BASELINE
TA_BOTTOM, TA_TOP, dan VTA_CENTER
TA_NOUPDATECP dan TA_UPDATECP

Untuk memverifikasi bahwa bendera tertentu diatur dalam nilai pengembalian fungsi ini:

Terapkan operator OR bitwise ke bendera dan bendera terkait.
Terapkan operator AND bitwise ke hasil dan nilai yang dikembalikan.
Uji kesetaraan hasil ini dan bendera .

Contoh

Misalnya, lihat Mengatur Perataan Teks.

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