IDWriteFontSet1::GetFilteredFonts(DWRITE_FONT_PROPERTYconst*,UINT32,BOOL,IDWriteFontSet1**) メソッド (dwrite_3.h)

指定されたプロパティでフィルター処理されたフォントのサブセットを取得します。

構文

HRESULT GetFilteredFonts(
        DWRITE_FONT_PROPERTY const *properties,
        UINT32                     propertyCount,
        BOOL                       selectAnyProperty,
  [out] IDWriteFontSet1            **filteredFontSet
);

パラメーター

properties

型: DWRITE_FONT_PROPERTY const *

フィルター処理するプロパティの一覧。

propertyCount

型: UINT32

フィルター処理するプロパティの数。

selectAnyProperty

型: BOOL

getFilteredFontIndices が任意のプロパティを選択する必要があるかどうかを true します。すべての交差部分を選択する必要があるかどうかを false します。

[out] filteredFontSet

型: IDWriteFontSet1**

IDWriteFontSet1 インターフェイスへのポインターのアドレス。 正常に完了すると、プロパティに一致するフォントのサブセットを表すオブジェクトへのポインターが設定され、それ以外の場合はポインターが nullptrに設定されます。

戻り値

型: HRESULT

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

備考

フィルターと一致するフォントがない場合、返されるサブセット オブジェクトは空になります (IDWriteFontSet::GetFontCount 呼び出すと 0 が返されますが、関数はエラーを返しません。 サブセットは、常に元のセット以下です。

必要条件

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