Share via

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 ビルド 20348
サポートされている最小のサーバー Windows 10 ビルド 20348
対象プラットフォーム Windows
ヘッダー dwrite_3.h
Library Dwrite.lib