次の方法で共有


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 場合、システム フォント コレクションが使用され、ダウンロード可能なフォントは使用されず、文字体裁ファミリ名 (DWRITE_FONT_FAMILY_MODEL_TYPOGRAPHIC) でグループ化されます。

必要条件

要件 価値
サポートされる最小クライアント Windows 10 ビルド 16299
サポートされる最小サーバー Windows 10 ビルド 16299
ターゲット プラットフォーム の ウィンドウズ
ヘッダー dwrite_3.h
ライブラリ Dwrite.lib