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

Recupera um conjunto de fontes correspondente com base nas entradas solicitadas, ordenadas para que as correspondências mais próximas sejam anteriores.

Sintaxe

HRESULT GetMatchingFonts(
  DWRITE_FONT_PROPERTY const   *fontProperty,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  IDWriteFontSet1              **matchingFonts
);

Parâmetros

fontProperty

Tipo: DWRITE_FONT_PROPERTY const *

Propriedade de fonte de interesse, como família tipográfica ou família de peso/stretch/estilo.

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.

matchingFonts

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 uma lista priorizada de fontes que correspondem às propriedades, caso contrário, define o ponteiro como nullptr.

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

Esse método pode produzir itens distintos que não estavam no conjunto de fontes original, incluindo itens com sinalizadores de simulação (se eles forem uma correspondência mais próxima à solicitação) e instâncias que não foram nomeadas pelo autor da fonte. Os itens dos mesmos recursos de fonte são recolhidos em um: a correspondência mais próxima possível.

Requisitos