共用方式為

IDWriteFontSetBuilder2：：AddFont 方法 （dwrite_3.h）

  • 發行項

將字型新增至要建置的集合，呼叫端提供足夠的資訊來搜尋及判斷座標軸範圍，避免需要開啟潛在的非本機字型。

語法

HRESULT AddFont(
  IDWriteFontFile              *fontFile,
  UINT32                       fontFaceIndex,
  DWRITE_FONT_SIMULATIONS      fontSimulations,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
  UINT32                       fontAxisRangeCount,
  DWRITE_FONT_PROPERTY const   *properties,
  UINT32                       propertyCount
);

參數

fontFile

類型：IDWriteFontFile*

要新增至集合的字型檔案參考物件。

fontFaceIndex

類型：UINT32

集合中字型臉部以零起始的索引。

fontSimulations

類型：DWRITE_FONT_SIMULATIONS

演演算法縮排和斜體化的字型臉部模擬旗標。

fontAxisValues

類型：DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

類型：UINT32

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

fontAxisRanges

類型：DWRITE_FONT_AXIS_RANGE const *

軸範圍清單。

fontAxisRangeCount

類型：UINT32

座標軸範圍的數目。

properties

類型：DWRITE_FONT_PROPERTY const *

要與參考產生關聯的屬性清單。

propertyCount

類型：UINT32

定義的屬性數目。

傳回值

類型：HRESULT

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

言論

字型屬性至少應包含一個系列（印刷樣式或粗細/樣式/伸展）。 否則，IDWriteFontSet 只能依索引而非名稱存取字型。

要求

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