AddFontResourceA 函式 (wingdi.h)
AddFontResource函式會將字型資源從指定的檔案新增至系統字型表格。 字型後續可供任何應用程式用於文字輸出。
若要將字型標示為私用或不可列舉,請使用 AddFontResourceEx 函 式。
語法
int AddFontResourceA(
[in] LPCSTR unnamedParam1
);
參數
[in] unnamedParam1
包含有效字型檔案名之 Null 終止字元字串的指標。 此參數可以指定下列任何檔案。
若要新增其資訊來自數個資源檔的字型,請讓 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 |