IDWriteFontSetBuilder2::AddFont メソッド (dwrite_3.h)

作成中のセットにフォントを追加します。呼び出し元は軸の範囲を検索して決定するのに十分な情報を提供するため、ローカル以外の可能性があるフォントを開く必要がなくなります。

構文

HRESULT AddFont(
  IDWriteFontFile              *fontFile,
  UINT32                       fontFaceIndex,
  DWRITE_FONT_SIMULATIONS      fontSimulations,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
  UINT32                       fontAxisRangeCount,
  DWRITE_FONT_PROPERTY const   *properties,
  UINT32                       propertyCount
);

パラメーター

fontFile

型: IDWriteFontFile*

セットに追加するフォント ファイル参照オブジェクト。

fontFaceIndex

型: UINT32

コレクション内のフォントフェイスの 0 から始まるインデックス。

fontSimulations

型: DWRITE_FONT_SIMULATIONS

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

fontAxisValues

型: DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

型: UINT32

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

fontAxisRanges

型: DWRITE_FONT_AXIS_RANGE const *

軸範囲の一覧。

fontAxisRangeCount

型: UINT32

軸範囲の数。

properties

型: DWRITE_FONT_PROPERTY const *

参照に関連付けるプロパティの一覧。

propertyCount

型: UINT32

定義されたプロパティの数。

戻り値

型: HRESULT

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

備考

フォント プロパティには、少なくともファミリ (文字体裁または太さ/スタイル/ストレッチ) を含める必要があります。 それ以外の場合は、IDWriteFontSet で、名前ではなくインデックスによってのみフォントにアクセスできます。

必要条件