Fungsi AddFontResourceA (wingdi.h)

Artikel
08/27/2023

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.

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, 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