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 |