次の方法で共有

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 *

フォント プロパティ (文字体裁ファミリ、weight/stretch/style ファミリなど)。

fontAxisValues

型: DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

型: UINT32

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

matchingFonts

型: IDWriteFontSet1**

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

戻り値

型: HRESULT

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

備考

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

必要条件

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