createScalableFontResourceW 函式 (wingdi.h)

發行項
03/04/2024

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

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

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

語法

BOOL CreateScalableFontResourceW(
  [in] DWORD   fdwHidden,
  [in] LPCWSTR lpszFont,
  [in] LPCWSTR lpszFile,
  [in] LPCWSTR lpszPath
);

參數

[in] fdwHidden

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

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

[in] lpszFont

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

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

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll