Fungsi AddFontResourceA (wingdi.h)
Fungsi AddFontResource menambahkan sumber daya font dari file yang ditentukan ke tabel font sistem. Font kemudian dapat digunakan untuk output teks oleh aplikasi apa pun.
Untuk menandai font sebagai privat atau tidak dapat dijumlahkan, gunakan fungsi AddFontResourceEx .
Sintaks
int AddFontResourceA(
[in] LPCSTR unnamedParam1
);
Parameter
[in] unnamedParam1
Penunjuk ke string karakter yang dihentikan null yang berisi nama file font yang valid. Parameter ini dapat menentukan salah satu file berikut.
Untuk menambahkan font yang informasinya berasal dari beberapa file sumber daya, minta lpszFileName menunjuk ke string dengan nama file yang dipisahkan oleh "|" --misalnya, abcxxxxx.pfm | abcxxxxx.pfb.
Mengembalikan nilai
Jika fungsi berhasil, nilai pengembalian menentukan jumlah font yang ditambahkan.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Tidak tersedia informasi kesalahan yang diperluas.
Keterangan
Aplikasi apa pun yang menambahkan atau menghapus font dari tabel font sistem harus memberi tahu jendela lain tentang perubahan dengan mengirim pesan WM_FONTCHANGE ke semua jendela tingkat atas dalam sistem operasi. Aplikasi harus mengirim pesan ini dengan memanggil fungsi SendMessage dan mengatur parameter hwnd ke HWND_BROADCAST.
Ketika aplikasi tidak lagi memerlukan sumber daya font yang dimuatnya dengan memanggil fungsi AddFontResource , aplikasi harus menghapus sumber daya tersebut dengan memanggil fungsi RemoveFontResource .
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 dimodifikasi, 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 AddFontResource 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
| 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 |