Fungsi TabbedTextOutA (winuser.h)

Artikel
08/28/2023

Fungsi TabbedTextOut menulis string karakter di lokasi tertentu, memperluas tab ke nilai yang ditentukan dalam array posisi tab-stop. Teks ditulis dalam font, warna latar belakang, dan warna teks yang saat ini dipilih.

Sintaks

LONG TabbedTextOutA(
  [in] HDC       hdc,
  [in] int       x,
  [in] int       y,
  [in] LPCSTR    lpString,
  [in] int       chCount,
  [in] int       nTabPositions,
  [in] const INT *lpnTabStopPositions,
  [in] int       nTabOrigin
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] x

Koordinat x dari titik awal string, dalam unit logis.

[in] y

Koordinat y dari titik awal string, dalam unit logis.

[in] lpString

Penunjuk ke string karakter untuk menggambar. String tidak perlu dihentikan nol, karena nCount menentukan panjang string.

[in] chCount

Panjang string yang ditujukan ke oleh lpString.

[in] nTabPositions

Jumlah nilai dalam array posisi tab-stop.

[in] lpnTabStopPositions

Penunjuk ke array yang berisi posisi tab-stop, dalam unit logis. Perhentian tab harus diurutkan dalam urutan yang meningkat; nilai x terkecil harus menjadi item pertama dalam array.

[in] nTabOrigin

Koordinat x dari posisi awal dari mana tab diperluas, dalam unit logis.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah dimensi, dalam unit logis, dari string. Tingginya dalam kata berurutan tinggi dan lebarnya dalam kata berurutan rendah.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Jika parameter nTabPositions adalah nol dan parameter lpnTabStopPositions adalah NULL, tab diperluas hingga delapan kali lebar karakter rata-rata.

Jika nTabPositions adalah 1, perhentian tab dipisahkan oleh jarak yang ditentukan oleh nilai pertama dalam array lpnTabStopPositions .

Jika array lpnTabStopPositions berisi lebih dari satu nilai, perhentian tab diatur untuk setiap nilai dalam array, hingga angka yang ditentukan oleh nTabPositions.

Parameter nTabOrigin memungkinkan aplikasi memanggil fungsi TabbedTextOut beberapa kali untuk satu baris. Jika aplikasi memanggil TabbedTextOut lebih dari sekali dengan nTabOrigin diatur ke nilai yang sama setiap kali, fungsi memperluas semua tab relatif terhadap posisi yang ditentukan oleh nTabOrigin.

Secara default, posisi saat ini tidak digunakan atau diperbarui oleh fungsi TabbedTextOut . Jika aplikasi perlu memperbarui posisi saat ini saat memanggil TabbedTextOut, aplikasi dapat memanggil fungsi SetTextAlign dengan parameter wFlags diatur ke TA_UPDATECP. Ketika bendera ini diatur, sistem mengabaikan parameter X dan Y pada panggilan berikutnya ke fungsi TabbedTextOut , menggunakan posisi saat ini sebagai gantinya.

Catatan Untuk Windows Vista dan yang lebih baru, TabbedTextOut mengabaikan perataan teks saat menggambar teks.

Catatan

Header winuser.h mendefinisikan TabbedTextOut sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

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	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-misc-l1-5-1 (diperkenalkan dalam Windows 10, versi 10.0.14393)