共用方式為


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