IDWriteFontSet1::GetMatchingFonts メソッド (dwrite_3.h)

要求された入力に基づいて一致するフォント セットを取得し、より近い一致が前になるように並べ替えます。

構文

HRESULT GetMatchingFonts(
  DWRITE_FONT_PROPERTY const   *fontProperty,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  IDWriteFontSet1              **matchingFonts
);

パラメーター

fontProperty

型: DWRITE_FONT_PROPERTY const *

フォント プロパティ (文字体裁ファミリ、体重/ストレッチ/スタイル ファミリなど)。

fontAxisValues

型: DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

種類: UINT32

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

matchingFonts

種類: IDWriteFontSet1**

IDWriteFontSet1 インターフェイスへのポインターのアドレス。 正常に完了すると、関数はプロパティに一致するフォントの優先順位付けされたリストにポインターを設定し、それ以外の場合は ポインターを に nullptr設定します。

戻り値

種類: HRESULT

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

解説

このメソッドを使用すると、元のフォント セットに含まれていない個別のアイテム (シミュレーション フラグを持つ項目 (要求に近い場合) や、フォント作成者によって名前が付けられていたインスタンスなど) を生成できます。 同じフォント リソースのアイテムは、可能な限り最も近い一致に折りたたまれます。

要件

サポートされている最小のクライアント	Windows 10 ビルド 20348
サポートされている最小のサーバー	Windows 10 ビルド 20348
対象プラットフォーム	Windows
ヘッダー	dwrite_3.h
Library	Dwrite.lib