Método IDWriteFontSet::GetMatchingFonts(DWRITE_FONT_PROPERTYconst*,UINT32,IDWriteFontSet**) (dwrite_3.h)

Retorna um subconjunto de fontes filtradas pelas propriedades fornecidas.

Sintaxe

HRESULT GetMatchingFonts(
  DWRITE_FONT_PROPERTY const *properties,
  UINT32                     propertyCount,
  IDWriteFontSet             **filteredSet
);

Parâmetros

properties

Tipo: [in] const DWRITE_FONT_PROPERTY*

Lista de propriedades a serem filtradas usando.

propertyCount

Tipo: UINT32

O número de propriedades a serem filtradas.

filteredSet

Tipo: [out] IDWriteFontSet**

O subconjunto de fontes que correspondem às propriedades ou nullptr em caso de falha.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se nenhuma fonte corresponder ao filtro, o subconjunto estará vazio (GetFontCount retornará 0), mas a função não retornará um erro. O subconjunto sempre será igual ou menor que o conjunto original. Se você quiser filtrar apenas fontes remotas, poderá passar nulo em propriedades e zero em propertyCount.

Requisitos

Confira também

IDWriteFontSet