Fungsi EnumFontFamiliesA (wingdi.h)

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.

 

Sintaksis

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 null-terminated yang menentukan nama keluarga font yang diinginkan. Jika lpszFamilyNULL, EnumFontFamilies memilih dan menghitung satu font dari setiap keluarga jenis yang tersedia.

[in] lpProc

Penunjuk ke fungsi panggilan balik yang ditentukan aplikasi. Untuk informasi, lihatEnumFontFamProc .

[in] lParam

Penunjuk ke data yang disediakan aplikasi. Data diteruskan ke fungsi panggilan balik bersama dengan informasi font.

Mengembalikan nilai

Nilai yang dikembalikan adalah nilai terakhir yang dikembalikan oleh fungsi panggilan balik. Artinya adalah implementasi spesifik.

Komentar

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.

Nota

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

Lihat juga

EnumFontFamProc

EnumFontFamiliesEx

EnumFonts

Fungsi Font dan Teks

Font dan Gambaran Umum Teks