共用方式為

IDWriteFontSet4：：GetMatchingFonts 方法 （dwrite_3.h）

  • 發行項

根據要求的輸入產生相符的字型集，並依循序排序，以便較接近的相符專案。

語法

HRESULT GetMatchingFonts(
  WCHAR const                  *familyName,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_SIMULATIONS      allowedSimulations,
  IDWriteFontSet4              **matchingFonts
);

參數

familyName

類型：_In_z_ WCHAR const*

字型系列名稱。 這可以是：印刷系列名稱、權數/伸展/樣式系列名稱、GDI （RBIZ） 系列名稱或全名。

fontAxisValues

類型：_In_reads_（fontAxisValueCount） DWRITE_FONT_AXIS_VALUE const*

字型座標軸值的陣列。

fontAxisValueCount

類型：UINT32

字型座標軸值的數目。

allowedSimulations

類型：DWRITE_FONT_SIMULATIONS

指定哪些模擬（也就是演算法的縮排和/或斜線）可以套用至相符的字型，以更符合指定的座標軸值。 如果自變數是 DWRITE_FONT_SIMULATIONS_NONE （0），則不會套用任何模擬。

matchingFonts

類型：_COM_Outptr_ IDWriteFontSet4**

接收新建立字型集的指標，其中包含符合指定輸入之字型的優先順序清單。

傳回值

類型：HRESULT

如果函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT錯誤碼。

言論

這可以產生不在原始字型集中的不同專案，包括具有模擬旗標的專案（如果它們與要求更相符），以及不是由字型作者命名的實例。 來自相同字型資源的專案會折疊成一個：最接近的可能相符專案。

要求

要求 價值
最低支援的用戶端 Windows 11 組建 22621
標頭 dwrite_3.h
連結庫 Dwrite.lib
DLL Dwrite.dll