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

Artigo
07/16/2024

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_ const* do WCHAR

Nome da família de fontes. Isso pode ser: um nome de família tipográfico, nome da família de peso/stretch/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, de 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.

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

Isso 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

Requisito	Valor
de cliente com suporte mínimo	Build 22621 do Windows 11
cabeçalho	dwrite_3.h
biblioteca	Dwrite.lib
de DLL	Dwrite.dll

Compartilhar via