IDWriteFontResource::CreateFontFace メソッド (dwrite_3.h)

特定の軸値を持つフォントフェイスインスタンスを作成します。

構文

HRESULT CreateFontFace(
        DWRITE_FONT_SIMULATIONS      fontSimulations,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontFace5             **fontFace
);

パラメーター

fontSimulations

型: DWRITE_FONT_SIMULATIONS

アルゴリズムのエンボデニングと斜体化のためのフォント面シミュレーション フラグ。

fontAxisValues

型: DWRITE_FONT_AXIS_VALUE const *

フォント軸の値のリストを含む配列へのポインター。 配列は、fontAxisValueCount 引数で示されるサイズ (要素の数) である必要があります。

fontAxisValueCount

型: UINT32

fontAxisValues 配列に含まれるフォント軸の値の数。

[out] fontFace

型: IDWriteFontFace5**

IDWriteFontFace5 インターフェイスへのポインターのアドレス。 正常に完了すると、関数は新しく作成されたフォントフェイスオブジェクトへのポインターを設定し、それ以外の場合はポインターを nullptrに設定します。

戻り値

型: HRESULT

関数が成功した場合は、S_OKを返します。 それ以外の場合は、HRESULTエラー コードを返します。

備考

指定する軸の値は、フォントで実際にサポートされているすべての軸のサブセットまたはスーパーセットであることが許可されます。 指定されていない軸では既定値が使用されます。範囲を超える値はクランプされ、変化しない軸には効果はありません。

必要条件