IDWriteFactory::CreateTextFormat メソッド

テキスト レイアウトに使用されるテキスト形式オブジェクトを作成します。

構文

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

パラメーター

• fontFamilyName [in]
  フォント ファミリの名前を含む文字配列。

• fontCollection
  フォント コレクション オブジェクトへのポインター。これが NULL の場合、システム フォント コレクションを示します。

• fontWeight
  このメソッドによって作成されるテキスト オブジェクトのフォントの太さを示す値。

• fontStyle
  このメソッドによって作成されるテキスト オブジェクトのフォント スタイルを示す値。

• fontStretch
  このメソッドによって作成されるテキスト オブジェクトのフォント伸縮を示す値。

• fontSize
  DIP ("デバイス非依存ピクセル") 単位でのフォントの論理サイズ。1 DIP は 1/96 インチです。

• localeName [in]
  ロケール名を含む文字配列。

• textFormat [out]
  このメソッドが返されるときに、新しく作成されたテキスト形式オブジェクトへのポインターのアドレスが格納されます。失敗した場合は NULL が格納されます。

戻り値

メソッドが成功した場合は、S_OK が返されます。 それ以外の場合は、エラー コードが返されます。HRESULT.

要件

参照

IDWriteFactory