Método IDWriteFontSet1::GetFilteredFonts(DWRITE_FONT_AXIS_RANGEconst*,UINT32,BOOL,IDWriteFontSet1**) (dwrite_3.h)

Recupera um subconjunto de fontes filtradas pelos intervalos fornecidos, inclusive ponto de extremidade.

Sintaxe

HRESULT GetFilteredFonts(
        DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
        UINT32                       fontAxisRangeCount,
        BOOL                         selectAnyRange,
  [out] IDWriteFontSet1              **filteredFontSet
);

Parâmetros

fontAxisRanges

Tipo: DWRITE_FONT_AXIS_RANGE const *

Lista de intervalos de valores de eixo pelo qual filtrar.

fontAxisRangeCount

Tipo: UINT32

O número de intervalos de valores de eixo a serem filtrados.

selectAnyRange

Tipo: BOOL

true se GetFilteredFonts deve selecionar qualquer intervalo; false se ele deve selecionar a interseção de todos eles.

[out] filteredFontSet

Tipo: IDWriteFontSet1**

O endereço de um ponteiro para uma interface IDWriteFontSet1 . Após a conclusão bem-sucedida, a função define o ponteiro para um objeto que representa o subconjunto de fontes que se enquadram nos intervalos, caso contrário, define o ponteiro como nullptr.

Retornar valor

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erroHRESULT.

Comentários

Se nenhuma fonte corresponder ao filtro, o objeto de subconjunto retornado estará vazio (chamando IDWriteFontSet::GetFontCount nele retorna 0), mas a função não retorna um erro. O subconjunto é sempre igual ou menor que o conjunto original.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10 Build 20348
Servidor mínimo com suporte	Windows 10 Build 20348
Plataforma de Destino	Windows
Cabeçalho	dwrite_3.h
Biblioteca	Dwrite.lib