Fungsi PolyTextOutA (wingdi.h)

Artikel
11/20/2024

Fungsi PolyTextOut menggambar beberapa string menggunakan font dan warna teks yang saat ini dipilih dalam konteks perangkat yang ditentukan.

Sintaksis

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.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Komentar

Setiap struktur POLYTEXT berisi koordinat titik referensi yang digunakan Windows untuk meratakan 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 panggilan internal sebelum beralih ke mode kernel, mengurangi beberapa masalah performa saat menimbang penggunaan PolyTextOut versus ExtTextOut.

Ujung

ExtTextOut sangat direkomendasikan daripada PolyTextOut untuk pengembangan modern karena kemampuannya untuk menangani tampilan bahasa yang berbeda.

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	wingdi.h (termasuk Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll