Fungsi RemoveFontResourceExA (wingdi.h)

Artikel
03/04/2024

Fungsi RemoveFontResourceEx menghapus font dalam file yang ditentukan dari tabel font sistem.

Sintaks

BOOL RemoveFontResourceExA(
  [in] LPCSTR name,
  [in] DWORD  fl,
  [in] PVOID  pdv
);

Parameter

[in] name

Penunjuk ke string yang dihentikan null yang menamai file sumber daya font.

[in] fl

Karakteristik font yang akan dihapus dari sistem. Agar font dihapus, bendera yang digunakan harus sama seperti ketika font ditambahkan dengan fungsi AddFontResourceEx . Lihat fungsi AddFontResourceEx untuk informasi selengkapnya.

[in] pdv

Dicadangkan. Harus nol.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Keterangan

Fungsi ini hanya akan menghapus font jika bendera yang ditentukan sama seperti ketika kemudian font ditambahkan dengan fungsi AddFontResourceEx .

Ketika Anda mencoba mengganti file font yang ada yang berisi font dengan referensi luar biasa untuk itu, Anda mungkin mendapatkan kesalahan yang menunjukkan bahwa font asli tidak dapat dihapus karena sedang digunakan bahkan setelah Anda memanggil RemoveFontResourceEx. Jika aplikasi Anda mengharuskan file font diganti, untuk mengurangi jumlah sumber daya font asli menjadi nol, panggil RemoveFontResourceEx dalam perulangan seperti yang ditunjukkan dalam kode contoh ini. Jika Anda terus mendapatkan kesalahan, ini adalah indikasi bahwa file font tetap dimuat dalam sesi lain. Pastikan font tidak tercantum dalam registri font dan mulai ulang sistem untuk memastikan font dibongkar dari semua sesi.

Catatan Aplikasi tempat file font asli digunakan masih akan dapat mengakses file asli dan tidak akan menggunakan font baru hingga font dimuat ulang. Panggil AddFontResourceEx untuk memuat ulang font. Kami menyarankan agar Anda memanggil AddFontResourceEx berapa kali yang sama dengan panggilan ke RemoveFontResourceEx berhasil seperti yang ditunjukkan dalam kode contoh ini.


int i = 0;
while( RemoveFontResourceEx( FontFile, FR_PRIVATE, 0 ) )
{
    i++;
}

// TODO: Replace font file

while( i-- )
{
    AddFontResourceEx( FontFile, FR_PRIVATE, 0 );
}

Catatan

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

TambahkanFontResourceEx

Fungsi Font dan Teks

Gambaran Umum Font dan Teks

SendMessage

Bagikan melalui