次の方法で共有


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

指定したフォント ファミリ内のフォントの一覧を、指定した軸の値とどの程度一致するか順にランク付けして取得します。

構文

HRESULT GetMatchingFonts(
        WCHAR const                  *familyName,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontList2             **fontList
);

パラメーター

familyName

型: WCHAR const *

フォント ファミリの名前。 名前は大文字と小文字は区別されませんが、それ以外の場合はコレクション内のファミリ名と完全に一致する必要があります。

fontAxisValues

型: DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

型: UINT32

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

[out] fontList

型: IDWriteFontList2**

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

戻り値

型: HRESULT

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

備考

フォントが一致しない場合は、空のリスト オブジェクトが返されますが (IDWriteFontList::GetFontCount 呼び出すと 0 が返されます)、関数はエラーを返しません。

必要条件

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