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
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 |