AddFontResourceA 函式（wingdi.h）

發行項
11/20/2024

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

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

語法

int AddFontResourceA(
  [in] LPCSTR unnamedParam1
);

參數

[in] unnamedParam1

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

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

若要新增資訊來自數個資源檔的字型，請讓 lpszFileName 指向以 “|” 分隔的檔名字符串 --例如 abcxxxxx.pfm |abcxxxxx.pfb。

傳回值

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

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

言論

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

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

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

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

注意

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

要求

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