Fungsi AddFontResourceExA (wingdi.h)

Fungsi AddFontResourceEx menambahkan sumber daya font dari file yang ditentukan ke sistem. Font yang ditambahkan dengan fungsi AddFontResourceEx dapat ditandai sebagai privat dan tidak dapat dijumlahkan.

Sintaks

int AddFontResourceExA(
  [in] LPCSTR name,
  [in] DWORD  fl,
  [in] PVOID  res
);

Parameter

[in] name

Penunjuk ke string karakter yang dihentikan null yang berisi nama file font yang valid. Parameter ini dapat menentukan salah satu file berikut.

Ekstensi File URL	Makna
.Fon	File sumber daya font.
.fnt	File font bitmap mentah.
.Ttf	File TrueType mentah.
.Ttc	Windows Asia Timur: Koleksi font TrueType.
.Fot	File sumber daya TrueType.
.otf	Font PostScript OpenType.
.Mmm	beberapa file sumber daya font Master Type1. Ini harus digunakan dengan file .pfm dan .pfb.
.pfb	Ketik 1 file bit font. Ini digunakan dengan file .pfm.
.pfm	Ketik 1 file metrik font. Ini digunakan dengan file .pfb.

 

Untuk menambahkan font yang informasinya berasal dari beberapa file sumber daya, arahkan lpszFileName ke string dengan nama file yang dipisahkan oleh | --misalnya, abcxxxxx.pfm | abcxxxxx.pfb.

[in] fl

Karakteristik font yang akan ditambahkan ke sistem. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
FR_PRIVATE	Menentukan bahwa hanya proses yang disebut fungsi AddFontResourceEx yang dapat menggunakan font ini. Ketika nama font cocok dengan font publik, font privat akan dipilih. Ketika proses berakhir, sistem akan menghapus semua font yang diinstal oleh proses dengan fungsi AddFontResourceEx .
FR_NOT_ENUM	Menentukan bahwa tidak ada proses, termasuk proses yang disebut fungsi AddFontResourceEx , dapat menghitung font ini.

[in] res

Dicadangkan. Harus nol.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan menentukan jumlah font yang ditambahkan.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Tidak tersedia informasi kesalahan yang diperluas.

Keterangan

Fungsi ini memungkinkan proses untuk menggunakan font tanpa mengizinkan proses lain mengakses font.

Ketika aplikasi tidak lagi memerlukan sumber daya font yang dimuatnya dengan memanggil fungsi AddFontResourceEx , aplikasi harus menghapus sumber daya dengan memanggil fungsi RemoveFontResourceEx .

Fungsi ini menginstal font hanya untuk sesi saat ini. Ketika sistem dimulai ulang, font tidak akan ada. Agar font terinstal bahkan setelah menghidupkan ulang sistem, font harus tercantum dalam registri.

Font yang tercantum dalam registri dan diinstal ke lokasi selain folder %windir%\fonts\ tidak dapat diubah, dihapus, atau diganti selama dimuat dalam sesi apa pun. Untuk mengubah salah satu font ini, pertama-tama harus dihapus dengan memanggil RemoveFontResource, dihapus dari registri font (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts), dan sistem dimulai ulang. Setelah menghidupkan ulang sistem, font tidak akan lagi dimuat dan dapat diubah.

Catatan

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

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

Lihat juga

Fungsi Font dan Teks

Font dan Gambaran Umum Teks

RemoveFontResourceEx

SendMessage