CreateFontIndirectExA 函式 (wingdi.h)

發行項
03/04/2024

CreateFontIndirectEx 函式會指定邏輯字型，該字型具有指定結構的特性。後續可以選取字型做為任何裝置內容的目前字型。

語法

HFONT CreateFontIndirectExA(
  [in] const ENUMLOGFONTEXDVA *unnamedParam1
);

參數

[in] unnamedParam1

ENUMLOGFONTEXDV 結構的指標，可定義多個主字型的特性。

請注意，此函式會忽略 ENUMLOGFONTEXDV 中的 elfDesignVector 成員。

傳回值

如果函式成功，則傳回值是新 ENUMLOGFONTEXDV 結構的句柄。

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

備註

CreateFontIndirectEx 函式會建立邏輯字型，其中包含 ENUMLOGFONTEXDV 結構中指定的特性。使用 SelectObject 函式選取此字型時，GDI 的字型對應器會嘗試比對邏輯字型與現有的實體字型。如果找不到完全相符專案，它會提供一個替代方案，其特性會盡可能比對許多要求的特性。

當您不再需要字型時，請呼叫 DeleteObject 函式來刪除它。

不論地區設定為何， CreateFont、 CreateFontIndirect 和 CreateFontIndirectEx 的字型對應程式都會辨識英文和本地化的字樣名稱。

注意

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

規格需求

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