CreateScalableFontResourceA 函式（wingdi.h）

發行項
11/20/2024

[CreateScalableFontResource 函式可用於需求區段中指定的操作系統。可能是

在後續版本中已改變或無法使用。]

CreateScalableFontResource 函式會建立可調整字型的字型資源檔。

語法

BOOL CreateScalableFontResourceA(
  [in] DWORD  fdwHidden,
  [in] LPCSTR lpszFont,
  [in] LPCSTR lpszFile,
  [in] LPCSTR lpszPath
);

參數

[in] fdwHidden

指定字型是否為唯讀字型。此參數可以是下列其中一個值。

價值	意義
0	字型具有讀取/寫入許可權。
1	字型具有唯讀許可權，而且應該隱藏於系統中的其他應用程式。設定此旗標時，EnumFonts 或 EnumFontFamilies 函式不會列舉字型。

[in] lpszFont

要建立之字型資源文件名稱的 Null 終止字串指標。如果此參數指定現有的字型資源檔，則函式會失敗。

[in] lpszFile

以 Null 結尾之字串的指標，指定此函式用來建立字型資源檔之可調整字型檔的名稱。

[in] lpszPath

指定可調整字型檔案路徑之 Null 終止字串的指標。

傳回值

如果函式成功，則傳回值為非零值。

如果函式失敗，傳回值為零。

如果 lpszFontRes 指定現有的字型檔案，GetLastError 會傳回ERROR_FILE_EXISTS

言論

安裝 TrueType 字型的應用程式會使用 CreateScalableFontResource 函式。應用程式會使用 CreateScalableFontResource 函式來建立字型資源檔（通常是擴展名為 .fot 的擴展名），然後使用 AddFontResource 函式來安裝字型。 TrueType 字型檔案（通常具有.ttf擴展名）必須位於 AddFontResource 函式要使用的 Windows 目錄系統子目錄中。

CreateScalableFontResource 函式目前僅支援 TrueType 技術可調整字型。

當 lpszFontFile 參數只指定檔名和擴展名時，lpszCurrentPath 參數必須指定路徑。當 lpszFontFile 參數指定完整路徑時，lpszCurrentPath 參數必須 NULL 或 NULL指標。

當在 lpszFontFile 參數中指定檔名和擴展名，且路徑是在 lpszCurrentPath 參數中指定時，lpszFontFile 中的字符串會複製到 .fot 檔案中，做為屬於此資源的.ttf檔案。呼叫 AddFontResource 函式時，操作系統會假設.ttf檔案已複製到系統目錄（或在網路安裝的情況下複製到主要 Windows 目錄）。呼叫 createScalableFontResource 函式時，.ttf檔案不需要在此目錄中，因為 lpszCurrentPath 參數包含目錄資訊。以這種方式建立的資源不包含絕對路徑資訊，而且可用於任何安裝。

在 lpszFontFile 參數中指定路徑，並在 lpszCurrentPath 參數中指定 null 時，lpszFontFile 中的字符串會複製到 .fot 檔案中。在此情況下，呼叫 AddFontResource 函式時，.ttf檔案必須位於呼叫 CreateScalableFontResource 函式時，lpszFontFile 參數中指定的位置;不需要 lpszCurrentPath 參數。以這種方式建立的資源包含路徑和磁碟驅動器的絕對參考，如果.ttf檔案移至不同的位置，則無法運作。

注意

wingdi.h 標頭會根據 UNICODE 預處理器常數的定義，將 CreateScalableFontResource 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	wingdi.h （包括 Windows.h）
連結庫	Gdi32.lib
DLL	Gdi32.dll