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
字型集合。 使用 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 |