Fungsi ExtTextOutA (wingdi.h)

Fungsi ExtTextOut menggambar teks menggunakan font, warna latar belakang, dan warna teks yang saat ini dipilih. Anda dapat secara opsional menyediakan dimensi yang akan digunakan untuk kliping, buram, atau keduanya.

Sintaksis

BOOL ExtTextOutA(
  [in] HDC        hdc,
  [in] int        x,
  [in] int        y,
  [in] UINT       options,
  [in] const RECT *lprect,
  [in] LPCSTR     lpString,
  [in] UINT       c,
  [in] const INT  *lpDx
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] x

Koordinat x, dalam koordinat logis, dari titik referensi yang digunakan untuk memposisikan string.

[in] y

Koordinat y, dalam koordinat logis, dari titik referensi yang digunakan untuk memposisikan string.

[in] options

Menentukan cara menggunakan persegi panjang yang ditentukan aplikasi. Parameter ini bisa berupa satu atau beberapa nilai berikut.

Nilai ETO_GLYPH_INDEX dan ETO_RTLREADING tidak dapat digunakan bersama-sama. Karena ETO_GLYPH_INDEX menyiratkan bahwa semua pemrosesan bahasa telah selesai, fungsi mengabaikan bendera ETO_RTLREADING jika juga ditentukan.

[in] lprect

Penunjuk ke struktur RECT opsional yang menentukan dimensi, dalam koordinat logis, persegi panjang yang digunakan untuk pengklipan, buram, atau keduanya.

[in] lpString

Penunjuk ke string yang menentukan teks yang akan digambar. String tidak perlu dihentikan nol, karena cbCount menentukan panjang string.

[in] c

Panjang string ditujukkan oleh lpString.

Nilai ini mungkin tidak melebihi 8192.

[in] lpDx

Penunjuk ke array nilai opsional yang menunjukkan jarak antara asal sel karakter yang berdekatan. Misalnya, unit logis lpDx[i] memisahkan asal sel karakter i dan sel karakter i + 1.

Mengembalikan nilai

Jika string digambar, nilai yang dikembalikan bukan nol. Namun, jika versi ANSI dari ExtTextOut dipanggil dengan ETO_GLYPH_INDEX, fungsi mengembalikan TRUE meskipun fungsi tidak melakukan apa-apa.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Komentar

Pengaturan perataan teks saat ini untuk konteks perangkat yang ditentukan menentukan bagaimana titik referensi digunakan untuk memosisikan teks. Pengaturan perataan teks diambil dengan memanggil fungsi GetTextAlign. Pengaturan perataan teks diubah dengan memanggil fungsi SetTextAlign. Anda bisa menggunakan nilai berikut untuk perataan teks. 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.

Jika parameter lpDx null, fungsi ExtTextOut menggunakan penspasian default antar karakter. Asal sel karakter dan konten array yang diacu oleh parameter lpDx ditentukan dalam unit logis. Asal sel karakter didefinisikan sebagai sudut kiri atas sel karakter.

Secara default, posisi saat ini tidak digunakan atau diperbarui oleh fungsi ini. Namun, aplikasi dapat memanggil fungsi SetTextAlign dengan parameter fMode diatur ke TA_UPDATECP untuk mengizinkan sistem menggunakan dan memperbarui posisi saat ini setiap kali aplikasi memanggil ExtTextOut untuk konteks perangkat tertentu. Ketika bendera ini diatur, sistem mengabaikan parameter X dan Y pada panggilan ExtTextOut berikutnya.

Untuk versi ANSI ExtTextOut, array lpDx memiliki jumlah nilai INT yang sama seperti ada byte dalam lpString. Untuk karakter DBCS, Anda dapat menambahkan dx dalam entri lpDx antara byte prospek dan byte jejak, selama jumlah dua byte ditambahkan ke dx yang diinginkan. Untuk karakter DBCS dengan versi Unicode ExtTextOut, setiap glyph Unicode mendapatkan satu entri pdx.

Catatan, nilai alpDx dari GetTextExtentExPoint tidak sama dengan nilai lpDx untuk ExtTextOut. Untuk menggunakan nilai alpDx di lpDx, Anda harus terlebih dahulu memprosesnya.

ExtTextOut akan menggunakan Uniscribe jika perlu menghasilkan fallback font. Bendera ETO_IGNORELANGUAGE akan menghambat perilaku ini dan tidak boleh diteruskan.

Selain itu, ExtTextOut akan melakukan batching panggilan internal sebelum beralih ke mode kernel, mengurangi beberapa masalah performa saat menimbang penggunaan PolyTextOut versus ExtTextOut.

Contoh

Misalnya, lihat "Mengatur Font untuk Menu-Item String Teks" di Menggunakan Menu.

Persyaratan

Lihat juga

Fungsi Font dan Teks

Font dan Gambaran Umum Teks

GetTextAlign

RECT

SelectObject

SetBkColor

SetTextAlign

SetTextColor