Fungsi EnumFontsA (wingdi.h)

Artikel
08/27/2023

Fungsi EnumFonts menghitung font yang tersedia pada perangkat tertentu. Untuk setiap font dengan nama typeface yang ditentukan, fungsi EnumFonts mengambil informasi tentang font tersebut dan meneruskannya ke fungsi panggilan balik yang ditentukan aplikasi. Fungsi panggilan balik ini dapat memproses informasi font seperti yang diinginkan. Enumerasi berlanjut sampai tidak ada lagi font atau fungsi panggilan balik mengembalikan nol.

Catatan Fungsi ini disediakan hanya untuk kompatibilitas dengan Windows versi 16-bit. Aplikasi harus menggunakan fungsi EnumFontFamiliesEx .

Sintaks

int EnumFontsA(
  [in] HDC           hdc,
  [in] LPCSTR        lpLogfont,
  [in] FONTENUMPROCA lpProc,
  [in] LPARAM        lParam
);

Parameter

[in] hdc

Handel ke konteks perangkat untuk menghitung font.

[in] lpLogfont

Penunjuk ke string null-terminated yang menentukan nama typeface dari font yang diinginkan. Jika lpFaceNameadalah NULL, EnumFonts secara acak memilih dan menghitung satu font dari setiap typeface yang tersedia.

[in] lpProc

Penunjuk ke fungsi definedcallback aplikasi. Untuk informasi selengkapnya, lihat EnumFontsProc.

[in] lParam

Penunjuk ke data yang ditentukan aplikasi apa pun. Data diteruskan ke fungsi panggilan balik bersama dengan informasi font.

Nilai kembali

Nilai yang dikembalikan adalah nilai terakhir yang dikembalikan oleh fungsi panggilan balik. Maknanya didefinisikan oleh aplikasi.

Keterangan

Gunakan EnumFontFamiliesEx alih-alih EnumFonts. Fungsi EnumFontFamiliesEx berbeda dari fungsi EnumFonts karena mengambil nama gaya yang terkait dengan font TrueType. Dengan EnumFontFamiliesEx, Anda dapat mengambil informasi tentang gaya font yang tidak dapat dijumlahkan menggunakan fungsi EnumFonts .

Font untuk banyak bahasa Asia Timur memiliki dua nama typeface: nama bahasa Inggris dan nama yang dilokalkan. EnumFonts, EnumFontFamilies, dan EnumFontFamiliesEx mengembalikan nama typeface bahasa Inggris jika lokal sistem tidak cocok dengan bahasa font.

Catatan

Header wingdi.h mendefinisikan EnumFonts 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