Fungsi EnumFontFamiliesA (wingdi.h)

Artikel
08/27/2023

Fungsi EnumFontFamilies menghitung font dalam keluarga font tertentu yang tersedia pada perangkat tertentu.

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

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