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

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

構文

HRESULT GetMatchingFonts(
  WCHAR const                  *familyName,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_SIMULATIONS      allowedSimulations,
  IDWriteFontSet4              **matchingFonts
);

パラメーター

familyName

型: _In_z_ WCHAR const*

フォント ファミリ名。 これは、文字体裁ファミリ名、重み/ストレッチ/スタイル ファミリ名、GDI (RBIZ) ファミリ名、またはフル ネームのいずれかです。

fontAxisValues

型: _In_reads_(fontAxisValueCount) DWRITE_FONT_AXIS_VALUE const*

フォント軸の値の配列。

fontAxisValueCount

型: UINT32

フォント軸の値の数。

allowedSimulations

種類: DWRITE_FONT_SIMULATIONS

指定した軸の値と一致するように、一致するフォントに適用できるシミュレーション (つまり、アルゴリズムによるエンボルディングや傾斜) を指定します。 引数が DWRITE_FONT_SIMULATIONS_NONE (0) の場合、シミュレーションは適用されません。

matchingFonts

種類: _COM_Outptr_ IDWriteFontSet4**

新しく作成されたフォント セットへのポインターを受け取ります。このセットには、指定された入力に一致するフォントの優先順位付き一覧が含まれます。

戻り値

型: HRESULT

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

注釈

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

要件

要件	値
サポートされている最小のクライアント	Windows 11 ビルド 22621
Header	dwrite_3.h
Library	Dwrite.lib
[DLL]	Dwrite.dll