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