AddFontResourceW 函式 (wingdi.h)

發行項
08/27/2023

AddFontResource函式會將字型資源從指定的檔案新增至系統字型表格。字型後續可供任何應用程式用於文字輸出。

若要將字型標示為私用或不可列舉，請使用 AddFontResourceEx 函式。

語法

int AddFontResourceW(
  [in] LPCWSTR unnamedParam1
);

參數

[in] unnamedParam1

包含有效字型檔案名之 Null 終止字元字串的指標。此參數可以指定下列任何檔案。

副檔名	意義
.fon	字型資源檔。
.fnt	原始點陣圖字型檔案。
.ttf	原始 TrueType 檔案。
。Ttc	東亞 Windows：TrueType 字型集合。
.fot	TrueType 資源檔。
.otf	PostScript OpenType 字型。
。嗯	多個主要 Type1 字型資源檔。它必須搭配 .pfm 和 .pfb 檔案使用。
.pfb	輸入 1 個字型位檔案。它會與 .pfm 檔案搭配使用。
。烤瓷	輸入 1 個字型計量檔案。它會與 .pfb 檔案搭配使用。

若要新增其資訊來自數個資源檔的字型，請讓 lpszFileName 指向具有以「|」分隔之檔案名的字串，例如 abcxxxxx.pfm |abcxxxxx.pfb。

傳回值

如果函式成功，傳回值會指定新增的字型數目。

如果此函式失敗，則傳回值為零。沒有可用的擴充錯誤資訊。

備註

從系統字型表格新增或移除字型的任何應用程式，都應該將 WM_FONTCHANGE 訊息傳送至作業系統中的所有最上層視窗，以通知其他視窗變更。應用程式應該藉由呼叫 SendMessage 函式並將 hwnd 參數設定為 HWND_BROADCAST 來傳送此訊息。

當應用程式不再需要透過呼叫 AddFontResource 函式載入的字型資源時，它必須藉由呼叫 RemoveFontResource 函式來移除該資源。

此函式只會安裝目前會話的字型。當系統重新開機時，字型將不會存在。若要在重新開機系統之後安裝字型，字型必須列在登錄中。

登錄中所列並安裝到 %windir%\fonts\ 資料夾以外的位置，只要在任何會話中載入該字型，就無法修改、刪除或取代該字型。若要變更其中一個字型，必須先呼叫 RemoveFontResource來移除它，從字型登錄中移除 (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts) ，然後系統重新開機。重新開機系統之後，將不會再載入字型，而且可以變更。

注意

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

規格需求


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