AddFontResourceExA 函式 （wingdi.h）

AddFontResourceEx 函式會將指定檔案中的字型資源新增至系統。 新增 AddFontResourceEx 函式的字型可以標示為私用且不可列舉。

語法

int AddFontResourceExA(
  [in] LPCSTR name,
  [in] DWORD  fl,
  [in] PVOID  res
);

參數

[in] name

包含有效字型檔名之 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。

[in] fl

要新增至系統之字型的特性。 此參數可以是下列其中一個值。

價值	意義
FR_PRIVATE	指定只有呼叫 AddFontResourceEx 函式的程式才能使用此字型。 當字型名稱符合公用字型時，將會選擇私人字型。 當進程終止時，系統會使用 addFontResourceEx 函式，移除進程所安裝的所有字型。
FR_NOT_ENUM	指定沒有進程，包括呼叫 AddFontResourceEx 函式的程式，可以列舉此字型。

[in] res

保留。 必須是零。

傳回值

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

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

言論

此函式可讓進程使用字型，而不允許其他進程存取字型。

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

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

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

注意

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

要求

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

另請參閱

字型和文字函式

字型和文字概觀

RemoveFontResourceEx

SendMessage