函式功能
該函式為一種可升級的字型創建一個字型資源檔案。函式原型
BOOL CreateScalableFontResource(DWORD fdwHidden, LPCTSTR lpszFontRes, LPCTSTR lpszFontFile, LPCTSTR lpszCurrentPath);重要參數
fdwHidden:指定此字型是否是一種嵌入式唯讀字型,此參數可取下列值之一:0:此字型有讀寫許可權。
1:此字型有隻讀許可權,並且必須對系統的其他應用程式隱藏起來,當此值設定時,此字型不能被函式EnumFonts和EnumFontFamilies列舉出來。
lpszFontRes:指向指定此函式創建的字型資源檔案名稱字的,以\0結束的字元串的指針。
lpszfontFile:指向以\0結束的字元串的指針,該字元串指定用於創建字型資源檔案的可升級字全檔案的名字。
lpszCurrentPath:指向指定可升級字型檔路徑的,以\0結束的字元串的指針。
返回值:如果函式調用成功,返回值非零;如果函式調用失敗,返回值是0。
Windows NT:若想獲得更多錯誤信息,請調用GetLastError函式。
備註:函式CreateScalableFontResource被那些安裝TrueType字型的應用程式使用。一個應用程式可用CreateScalableFontResource來創建一個字型資源檔案(通常有.FOT擴展名),然後用函式AddFontResource安裝字型。TrueTpe字型檔(通常有.TTF擴展名)必須在WINDOWS目錄下的SYSTEM子目錄中,被函式AddFontResource使用。
CreateScalableFontResource目前只支持TrueType技術升級字型。
當參數lpszFontFile只指定一個檔案名稱和擴展名時,lpszCurrentPath必須指定一個路徑。
當參數lpszFontFile指定了一個完整的路徑,則lpszCurrentPath必須為NULL,或者為指向NULL的指針。
當參數lpszFontFile指定了一個檔案名稱和擴展名,且lpszCurrentPath中指定路徑時,在lpszFontFile中的字元串被拷貝到.FOT檔案,象屬於此資源的.TTF一樣。當AddFontResource被調用時,作業系統假定.TTF檔案被拷貝到SYSTEM目錄下(或者有網路安裝的情況下到主Windows目錄下)。當CreateScalableFontResource被調用時,.TTF檔案不必在這個目錄下,因為lpszCurrentPath包含了目錄信息,在這種情況下創建的資源不包含絕對路徑,可以被任意安裝使用。
當lpszFontFile指定了路徑,且lpszCurrentPath被指定為NULL,則在lpszFontFile中的字元串被拷貝到.FOT檔案,在這種情況下,當函式AddFontResource被調用時,.TTF檔案必須在參數lpszFontFile指定的位置處,當CreateScalableFontResource調用時,lpszCurrentPath參數不需要,這種情況下創建的資源含有對路徑和驅動器的絕對訪問,當.TTF被移到不同的位置時,就不能使用。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:不支持;頭檔案:wingdi.h;庫檔案:gdi32.lib;Unicode:在Windows NT環境下以Unicode和ANSI兩種方式實現。