Fungsi CreateScalableFontResourceA (wingdi.h)
[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 |
|---|---|
|
Fonta memiliki izin baca/tulis. |
|
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 |