Fungsi PolyTextOutA (wingdi.h)

Artikel
03/13/2024

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