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 字型。
。嗯	多個主要 Type1 字型資源檔。 它必須與 .pfm 和 .pfb 檔案搭配使用。
.pfb	輸入1個字型位檔案。 它會與 .pfm 檔案搭配使用。
。烤 瓷	輸入 1 個字型計量檔案。 它會與 .pfb 檔案搭配使用。

 

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

[in] fl

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

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

[in] res

保留的。 必須為零。

傳回值

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

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

備註

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

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

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

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

注意

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

規格需求

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

另請參閱

字型和文字函式

字型和文字概觀

RemoveFontResourceEx

SendMessage