共用方式為

IDWriteFactory6：：CreateTextFormat 方法 (dwrite_3.h)

  • 發行項

建立用於文字版面配置的文字格式物件。

語法

HRESULT CreateTextFormat(
  WCHAR const                  *fontFamilyName,
  IDWriteFontCollection        *fontCollection,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  FLOAT                        fontSize,
  WCHAR const                  *localeName,
  IDWriteTextFormat3           **textFormat
);

參數

fontFamilyName

類型： WCHAR const *

集合中字型系列的名稱。

fontCollection

類型： IDWriteFontCollection*

字型集合。 使用 nullptr 來表示系統字型集合。

fontAxisValues

類型： DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

類型： UINT32

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

fontSize

類型： FLOAT

以 DIP 單位表示字型的邏輯大小。

localeName

類型： WCHAR const *

地區設定名稱 (例如 「ja-JP」、“en-US”、“ar-EG”) 。

textFormat

類型： IDWriteTextFormat3**

IDWriteTextFormat3 介面指標的位址。 成功完成時，函式會將指標設定為新建立的文字格式對象，否則會將指標設定為 nullptr。

傳回值

類型： HRESULT

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

備註

如果 fontCollection 為 nullptr，則會使用系統字型集合，並依印刷樣式系列名稱分組， (DWRITE_FONT_FAMILY_MODEL_TYPOGRAPHIC ) ，而不需可下載的字型。

規格需求

需求 值
最低支援的用戶端 Windows 10 組建 20348
最低支援的伺服器 Windows 10 組建 20348
目標平台 Windows
標頭 dwrite_3.h
程式庫 Dwrite.lib