IDWriteFactory6::CreateFontFaceReference メソッド (dwrite_3.h)

ファイル内の特定のフォント インスタンスへの参照を作成します。

構文

HRESULT CreateFontFaceReference(
        IDWriteFontFile              *fontFile,
        UINT32                       faceIndex,
        DWRITE_FONT_SIMULATIONS      fontSimulations,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontFaceReference1    **fontFaceReference
);

パラメーター

fontFile

型: IDWriteFontFile*

フォントフェイスを表すユーザー指定のフォント ファイル。

faceIndex

型: UINT32

フォント ファイルにフォントフェイスのコレクションが含まれている場合の、フォントフェイスの 0 から始まるインデックス。 フォント ファイルに単一の面が含まれている場合は、この値を 0 に設定します。

fontSimulations

型: DWRITE_FONT_SIMULATIONS

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

fontAxisValues

型: DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

型: UINT32

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

[out] fontFaceReference

型: IDWriteFontFaceReference1**

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

戻り値

型: HRESULT

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

必要条件

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