IDWriteFactory3::CreateFontFaceReference(WCHARconst*,FILETIMEconst*,UINT32,DWRITE_FONT_SIMULATIONS,IDWriteFontFaceReference**) メソッド (dwrite_3.h)

完全パスを指定してフォントへの参照を作成します。

構文

HRESULT CreateFontFaceReference(
  WCHAR const              *filePath,
  FILETIME const           *lastWriteTime,
  UINT32                   faceIndex,
  DWRITE_FONT_SIMULATIONS  fontSimulations,
  IDWriteFontFaceReference **fontFaceReference
);

パラメーター

filePath

種類: [入力] WCHAR

絶対ファイル パス。 ユーザーが指定した filePath がディスク上の有効なファイルに対応していない場合、構築されたオブジェクトに対する後続の操作が失敗する可能性があります。

lastWriteTime

種類: [in, optional] FILETIME

入力ファイル パスの最終変更時刻。 パラメーターを省略すると、
関数はフォント ファイルにアクセスして最後の書き込み時刻を取得するため、クライアントはこの値を指定することをお勧めします
余分なディスク アクセスを避けるために。 構築されたオブジェクトに対する後続の操作が失敗する可能性がある
ユーザーが lastWriteTime を指定した場合は、ディスク上のファイルと一致しません。

faceIndex

型: UINT32

フォント ファイルにフォントフェイスのコレクションが含まれている場合の、フォント面の 0 から始まるインデックス。
フォント ファイルに 1 つの顔が含まれている場合、この値は 0 にする必要があります。

fontSimulations

種類: DWRITE_FONT_SIMULATIONS

アルゴリズムによるエンボルドと斜体化のためのフォント フェイス シミュレーション フラグ。

fontFaceReference

型: [out] IDWriteFontFaceReference**

新しく作成されたフォント顔参照オブジェクト、またはエラーが発生した場合は nullptr が含まれます。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

要件

サポートされている最小のクライアント	Windows 10 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	dwrite_3.h
Library	Dwrite.lib
[DLL]	Dwrite.dll

関連項目

IDWriteFactory3