CreateScalableFontResource

CreateScalableFontResource是一種函式，為一種可升級的字型創建一個字型資源檔案。

基本介紹

• 中文名：CreateScalableFontResource
• Windows NT：3.1及以上版本
• Windows：95及以上版本
• Windows CE：不支持

其他信息

函式原型：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安裝字型。TrueType字型檔案（通常有.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兩種方式實現。