Fungsi TabbedTextOutA (winuser.h)
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
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) |