IDWriteFontSet1：：GetMatchingFonts 方法 （dwrite_3.h）

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

語法

HRESULT GetMatchingFonts(
  DWRITE_FONT_PROPERTY const   *fontProperty,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  IDWriteFontSet1              **matchingFonts
);

參數

fontProperty

類型：DWRITE_FONT_PROPERTY const *

感興趣的字型屬性，例如印刷樣式系列或粗細/伸展/樣式系列。

fontAxisValues

類型：DWRITE_FONT_AXIS_VALUE const *

陣列的指標，其中包含字型座標軸值的清單。 數位應該是 fontAxisValueCount 自變數所指示的大小（元素數目）。

fontAxisValueCount

類型：UINT32

fontAxisValue s 陣列中包含的字型座標軸值數目。

matchingFonts

類型：IDWriteFontSet1**

IDWriteFontSet1 介面的指標位址。 成功完成時，函式會將指標設定為符合屬性之字型的優先順序清單，否則會將指標設定為 nullptr。

傳回值

類型：HRESULT

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

言論

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

要求

要求	價值
最低支援的用戶端	Windows 10 組建 20348
支援的最低伺服器	Windows 10 組建 20348
目標平臺	窗戶
標頭	dwrite_3.h
連結庫	Dwrite.lib