CreateScalableFontResourceA 函式 (wingdi.h)
[ CreateScalableFontResource 函式可用於需求一節中指定的作業系統。 可能是
在後續版本中已改變或無法使用。]
CreateScalableFontResource函式會建立可調整字型的字型資源檔。
語法
BOOL CreateScalableFontResourceA(
[in] DWORD fdwHidden,
[in] LPCSTR lpszFont,
[in] LPCSTR lpszFile,
[in] LPCSTR lpszPath
);
參數
[in] fdwHidden
指定字型是否為唯讀字型。 此參數可以是下列其中一個值。
值 | 意義 |
---|---|
|
字型具有讀取/寫入權限。 |
|
字型具有唯讀許可權,而且應該隱藏系統中的其他應用程式。 設定此旗標時, EnumFonts 或 EnumFontFamilies 函式不會列舉字型。 |
[in] lpszFont
指定要建立之字型資源檔名稱之 Null 終止字串的指標。 如果此參數指定現有的字型資源檔,函式會失敗。
[in] lpszFile
Null 終止字串的指標,指定此函式用來建立字型資源檔之可調整字型檔的名稱。
[in] lpszPath
指定可調整字型檔案路徑之 Null 終止字串的指標。
傳回值
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。
如果 lpszFontRes 指定現有的字型檔案, GetLastError 會傳回ERROR_FILE_EXISTS
備註
CreateScalableFontResource函式是由安裝 TrueType 字型的應用程式所使用。 應用程式會使用 CreateScalableFontResource 函式來建立字型資源檔, (通常副檔名為 .fot) ,然後使用 AddFontResource 函式來安裝字型。 TrueType 字型檔案 (通常副檔名為 .ttf) 必須位於 AddFontResource 函式要使用的 Windows 目錄系統子目錄中。
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函式時,呼叫CreateScalableFontResource函式時,.ttf 檔案必須位於lpszFontFile參數中指定的位置;不需要lpszCurrentPath參數。 以此方式建立的資源包含路徑和磁片磁碟機的絕對參考,如果 .ttf 檔案移至不同的位置,則無法運作。
注意
wingdi.h 標頭會根據 UNICODE 預處理器常數的定義,將 CreateScalableFontResource 定義為別名,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wingdi.h (包含 Windows.h) |
程式庫 | Gdi32.lib |
Dll | Gdi32.dll |