Fungsi PolyTextOutA (wingdi.h)
Fungsi PolyTextOut menggambar beberapa string menggunakan font dan warna teks yang saat ini dipilih dalam konteks perangkat yang ditentukan.
Sintaks
BOOL PolyTextOutA(
[in] HDC hdc,
[in] const POLYTEXTA *ppt,
[in] int nstrings
);
Parameter
[in] hdc
Handel ke konteks perangkat.
[in] ppt
Penunjuk ke array struktur POLYTEXT yang menjelaskan string yang akan digambar. Array berisi satu struktur untuk setiap string yang akan digambar.
[in] nstrings
Jumlah struktur POLYTEXT dalam array pptxt .
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol.
Keterangan
Setiap struktur POLYTEXT berisi koordinat titik referensi yang digunakan Windows untuk menyelaraskan string teks yang sesuai. Aplikasi dapat menentukan bagaimana titik referensi digunakan dengan memanggil fungsi SetTextAlign . Aplikasi dapat menentukan pengaturan perataan teks saat ini untuk konteks perangkat yang ditentukan dengan memanggil fungsi GetTextAlign .
Untuk menggambar satu string teks, aplikasi harus memanggil fungsi ExtTextOut .
PolyTextOut tidak akan menangani dukungan pembuatan skrip internasional secara otomatis. Untuk mendapatkan dukungan pembuatan skrip internasional, gunakan ExtTextOut sebagai gantinya. ExtTextOut akan menggunakan Uniscribe jika perlu menghasilkan fallback font. Selain itu, ExtTextOut akan melakukan batching internal panggilan sebelum beralih ke mode kernel, mengurangi beberapa masalah performa saat menimbang penggunaan PolyTextOut versus ExtTextOut.
Tip
ExtTextOut sangat direkomendasikan daripada PolyTextOut untuk pengembangan modern karena kemampuannya untuk menangani tampilan bahasa yang berbeda.
Catatan
Header wingdi.h mendefinisikan PolyTextOut 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 | wingdi.h (sertakan Windows.h) |
| Pustaka | Gdi32.lib |
| DLL | Gdi32.dll |