Fungsi EnumFontFamiliesA (wingdi.h)
Fungsi EnumFontFamilies menghitung font dalam keluarga font tertentu yang tersedia pada perangkat tertentu.
Sintaks
int EnumFontFamiliesA(
[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 yang dihentikan null yang menentukan nama keluarga font yang diinginkan. Jika lpszFamily adalah NULL, EnumFontFamilies memilih dan menghitung satu font dari setiap keluarga jenis yang tersedia.
[in] lpProc
Penunjuk ke fungsi panggilan balik yang ditentukan aplikasi. Untuk informasi, lihat EnumFontFamProc.
[in] lParam
Penunjuk ke data yang disediakan aplikasi. Data diteruskan ke fungsi panggilan balik bersama dengan informasi font.
Nilai kembali
Nilai yang dikembalikan adalah nilai terakhir yang dikembalikan oleh fungsi panggilan balik. Artinya adalah implementasi spesifik.
Keterangan
Untuk setiap font yang memiliki nama typeface yang ditentukan oleh parameter lpszFamily , fungsi EnumFontFamilies mengambil informasi tentang font tersebut dan meneruskannya ke fungsi yang ditunjukkan oleh parameter lpEnumFontFamProc . Fungsi panggilan balik yang ditentukan aplikasi dapat memproses informasi font sesuai keinginan. Enumerasi berlanjut sampai tidak ada lagi font atau fungsi panggilan balik mengembalikan nol.
Ketika mode grafik pada konteks perangkat diatur ke GM_ADVANCED menggunakan fungsi SetGraphicsMode dan bendera DEVICE_FONTTYPE diteruskan ke parameter FontType, fungsi ini mengembalikan daftar font tipe 1 dan OpenType pada sistem. Ketika mode grafik tidak diatur ke GM_ADVANCED, fungsi ini mengembalikan daftar font tipe 1, OpenType, dan TrueType pada sistem.
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.
Contoh
Misalnya, lihat Menghitung Font yang Diinstal.
Catatan
Header wingdi.h mendefinisikan EnumFontFamilies 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 |