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

Artigo
11/20/2024

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 de eixo de 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 de 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.

Valor de retorno

Tipo: HRESULT

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

Observações

Se nenhuma fonte corresponder, um objeto de lista vazio será retornado (chamando IDWriteFontList::GetFontCount retorna 0), mas a função não retorna um erro.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10 Build 16299
servidor com suporte mínimo	Windows 10 Build 16299
da Plataforma de Destino	Windows
cabeçalho	dwrite_3.h
biblioteca	Dwrite.lib

Compartilhar via