IDWriteFactory：：CreateTextFormat 方法 (dwrite.h)

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

語法

HRESULT CreateTextFormat(
  [in]  WCHAR const           *fontFamilyName,
        IDWriteFontCollection *fontCollection,
        DWRITE_FONT_WEIGHT    fontWeight,
        DWRITE_FONT_STYLE     fontStyle,
        DWRITE_FONT_STRETCH   fontStretch,
        FLOAT                 fontSize,
  [in]  WCHAR const           *localeName,
  [out] IDWriteTextFormat     **textFormat
);

參數

[in] fontFamilyName

類型： const WCHAR*

包含字型系列名稱的字元陣列

fontCollection

類型： IDWriteFontCollection*

字型集合物件的指標。 當這是 Null時，表示系統字型集合。

fontWeight

類型： DWRITE_FONT_WEIGHT

值，表示這個方法所建立之文字物件的字型粗細。

fontStyle

類型： DWRITE_FONT_STYLE

值，表示這個方法所建立之文字物件的字型樣式。

fontStretch

類型： DWRITE_FONT_STRETCH

值，表示這個方法所建立之文字物件的字型延展。

fontSize

類型： FLOAT

DIP 中字型的邏輯大小 (「與裝置無關的圖元」) 單位。 DIP 等於 1/96 英吋。

[in] localeName

類型： const WCHAR*

包含地區設定名稱的字元陣列。

[out] textFormat

類型： IDWriteTextFormat**

當這個方法傳回時，會包含新建立之文字格式物件的指標位址，或在發生失敗時包含 Null 。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

需求

最低支援的用戶端	適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	dwrite.h
程式庫	Dwrite.lib
Dll	Dwrite.dll

另請參閱

IDWriteFactory