Fungsi CreateScalableFontResourceA (wingdi.h)

Artikel
08/27/2023

[Fungsi CreateScalableFontResource tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Mungkin saja

diubah atau tidak tersedia dalam versi berikutnya.]

Fungsi CreateScalableFontResource membuat file sumber daya font untuk font yang dapat diskalakan.

Sintaks

BOOL CreateScalableFontResourceA(
  [in] DWORD  fdwHidden,
  [in] LPCSTR lpszFont,
  [in] LPCSTR lpszFile,
  [in] LPCSTR lpszPath
);

Parameter

[in] fdwHidden

Menentukan apakah fonta adalah font baca-saja. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
0	Fonta memiliki izin baca/tulis.
1	Fonta memiliki izin baca-saja dan harus disembunyikan dari aplikasi lain dalam sistem. Ketika bendera ini diatur, font tidak dijumlahkan oleh fungsi EnumFonts atau EnumFontFamilies .

[in] lpszFont

Penunjuk ke string yang dihentikan null yang menentukan nama file sumber daya font yang akan dibuat. Jika parameter ini menentukan file sumber daya font yang ada, fungsi gagal.

[in] lpszFile

Penunjuk ke string yang dihentikan null yang menentukan nama file font yang dapat diskalakan yang digunakan fungsi ini untuk membuat file sumber daya font.

[in] lpszPath

Penunjuk ke string yang dihentikan null yang menentukan jalur ke file font yang dapat diskalakan.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Jika lpszFontRes menentukan file font yang ada, GetLastError mengembalikan ERROR_FILE_EXISTS

Keterangan

Fungsi CreateScalableFontResource digunakan oleh aplikasi yang menginstal font TrueType. Aplikasi menggunakan fungsi CreateScalableFontResource untuk membuat file sumber daya font (biasanya dengan ekstensi nama file .fot) dan kemudian menggunakan fungsi AddFontResource untuk menginstal font. File font TrueType (biasanya dengan ekstensi nama file .ttf) harus berada di subdirektori Sistem direktori Windows yang akan digunakan oleh fungsi AddFontResource .

Fungsi CreateScalableFontResource saat ini hanya mendukung font yang dapat diskalakan berteknologi TrueType.

Ketika parameter lpszFontFile hanya menentukan nama file dan ekstensi, parameter lpszCurrentPath harus menentukan jalur. Ketika parameter lpszFontFile menentukan jalur lengkap, parameter lpszCurrentPath harus NULL atau pointer ke NULL.

Ketika hanya nama file dan ekstensi yang ditentukan dalam parameter lpszFontFile dan jalur ditentukan dalam parameter lpszCurrentPath , string dalam lpszFontFile disalin ke dalam file .fot sebagai file .ttf milik sumber daya ini. Ketika fungsi AddFontResource dipanggil, sistem operasi mengasumsikan bahwa file .ttf telah disalin ke direktori Sistem (atau ke direktori Windows utama dalam kasus penginstalan jaringan). File .ttf tidak perlu berada di direktori ini ketika fungsi CreateScalableFontResource dipanggil, karena parameter lpszCurrentPath berisi informasi direktori. Sumber daya yang dibuat dengan cara ini tidak berisi informasi jalur absolut dan dapat digunakan dalam penginstalan apa pun.

Ketika jalur ditentukan dalam parameter lpszFontFile dan NULL ditentukan dalam parameter lpszCurrentPath , string dalam lpszFontFile disalin ke dalam file .fot. Dalam hal ini, ketika fungsi AddFontResource dipanggil, file .ttf harus berada di lokasi yang ditentukan dalam parameter lpszFontFile ketika fungsi CreateScalableFontResource dipanggil; parameter lpszCurrentPath tidak diperlukan. Sumber daya yang dibuat dengan cara ini berisi referensi absolut ke jalur dan drive dan tidak berfungsi jika file .ttf dipindahkan ke lokasi yang berbeda.

Catatan

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