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
fontAxisValue s 陣列中包含的字型座標軸值數目。
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 組建 16299 |
支援的最低伺服器 | Windows 10 組建 16299 |
目標平臺 | 窗戶 |
標頭 | dwrite_3.h |
連結庫 | Dwrite.lib |