AddFontResourceExW 函式 (wingdi.h)

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

語法

int AddFontResourceExW(
  [in] LPCWSTR name,
  [in] DWORD   fl,
  [in] PVOID   res
);

參數

[in] name

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

副檔名	意義
.fon	字型資源檔。
.fnt	原始點陣圖字型檔案。
.ttf	原始 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_PRI加值稅E	指定只有呼叫 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 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll

另請參閱

字型和文字函式

字型和文字概觀

RemoveFontResourceEx

SendMessage