共用方式為

IDWriteFontCollection2：：GetMatchingFonts 方法 （dwrite_3.h）

  • 發行項

擷取指定字型系列中的字型清單，依符合指定座標軸值的順序排序。

語法

HRESULT GetMatchingFonts(
        WCHAR const                  *familyName,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontList2             **fontList
);

參數

familyName

類型：WCHAR const *

字型系列的名稱。 名稱不區分大小寫，但必須完全符合集合中的系列名稱。

fontAxisValues

類型：DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

類型：UINT32

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

[out] fontList

類型：IDWriteFontList2**

IDWriteFontList2 介面的指標位址。 成功完成時，函式會將指標設定為新建立的字型清單物件。

傳回值

類型：HRESULT

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

言論

如果沒有字型相符，則會傳回空的清單物件（呼叫 idWriteFontList：：GetFontCount 傳回 0），但函式不會傳回錯誤。

要求

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