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

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

Sintaxe

HRESULT GetMatchingFonts(
  WCHAR const                  *familyName,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_SIMULATIONS      allowedSimulations,
  IDWriteFontSet4              **matchingFonts
);

Parâmetros

familyName

Tipo: _In_z_ WCHAR const*

Nome da família de fontes. Isso pode ser: um nome de família tipográfico, nome da família de peso/alongamento/estilo, nome da família GDI (RBIZ) ou nome completo.

fontAxisValues

Tipo: _In_reads_(fontAxisValueCount) DWRITE_FONT_AXIS_VALUE const*

Matriz de valores de eixo de fonte.

fontAxisValueCount

Tipo: UINT32

Número de valores de eixo de fonte.

allowedSimulations

Tipo: DWRITE_FONT_SIMULATIONS

Especifica quais simulações (ou seja, o incentivo algorítmico e/ou inclinação) podem ser aplicadas a fontes correspondentes para corresponder melhor aos valores de eixo especificados. Se o argumento for DWRITE_FONT_SIMULATIONS_NONE (0), nenhuma simulação será aplicada.

matchingFonts

Tipo: _COM_Outptr_ IDWriteFontSet4**

Recebe um ponteiro para um conjunto de fontes recém-criado, que contém uma lista priorizada de fontes que correspondem às entradas especificadas.

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

Isso pode produzir itens distintos que não estavam no conjunto de fontes original, incluindo itens com sinalizadores de simulação (se eles seriam uma correspondência mais próxima da 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

Requisito	Valor
Cliente mínimo com suporte	Windows 11 Build 22621
Cabeçalho	dwrite_3.h
Biblioteca	Dwrite.lib
DLL	Dwrite.dll