Método IDWriteFontCollection2::GetMatchingFonts (dwrite_3.h)

Recupera uma lista de fontes na família de fontes especificada, classificada em ordem de quão bem elas correspondem aos valores de eixo especificados.

Sintaxe

HRESULT GetMatchingFonts(
        WCHAR const                  *familyName,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontList2             **fontList
);

Parâmetros

familyName

Tipo: WCHAR const *

Nome da família de fontes. O nome não diferencia maiúsculas de minúsculas, mas deve corresponder exatamente a um nome de família na coleção.

fontAxisValues

Tipo: DWRITE_FONT_AXIS_VALUE const *

Um ponteiro para uma matriz que contém uma lista de valores do eixo da fonte. A matriz deve ser o tamanho (o número de elementos) indicado pelo argumento fontAxisValueCount .

fontAxisValueCount

Tipo: UINT32

O número de valores de eixo de fonte contidos na matriz fontAxisValues .

[out] fontList

Tipo: IDWriteFontList2**

O endereço de um ponteiro para uma interface IDWriteFontList2 . Após a conclusão bem-sucedida, a função define o ponteiro para um objeto de lista de fontes recém-criado.

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, um objeto de lista vazio será retornado (chamando IDWriteFontList::GetFontCount nele retorna 0), mas a função não retorna um erro.

Requisitos