Menentukan apakah font adalah font baca-saja. Parameter ini bisa menjadi salah satu nilai berikut.
Nilai
Arti
0
Font memiliki izin baca/tulis.
1
Font 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 null-terminated 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 null-terminated 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
Komentar
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) lalu 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 penunjuk keNULL .
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
Syarat
Nilai
klien minimum yang didukung
Windows 2000 Professional [hanya aplikasi desktop]