CreateScalableFontResourceA 函式 (wingdi.h)

發行項
08/27/2023

[ 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

備註

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