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

Genera un conjunto de fuentes coincidente basado en las entradas solicitadas, ordenadas para que las coincidencias más cercanas sean anteriores.

Sintaxis

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

Nombre de familia de fuentes. Puede ser: un nombre de familia tipográfico, un nombre de familia de peso/ stretch/estilo, un nombre de familia GDI (RBIZ) o un nombre completo.

fontAxisValues

Tipo: _In_reads_(fontAxisValueCount) DWRITE_FONT_AXIS_VALUE const*

Matriz de valores del eje de fuentes.

fontAxisValueCount

Tipo: UINT32

Número de valores del eje de fuentes.

allowedSimulations

Tipo: DWRITE_FONT_SIMULATIONS

Especifica qué simulaciones (es decir, la embolación algorítmica o slant) se pueden aplicar a fuentes coincidentes para que coincidan mejor con los valores de eje especificados. Si el argumento es DWRITE_FONT_SIMULATIONS_NONE (0), no se aplica ninguna simulación.

matchingFonts

Tipo: _COM_Outptr_ IDWriteFontSet4

Recibe un puntero a un conjunto de fuentes recién creado, que contiene una lista prioritaria de fuentes que coinciden con las entradas especificadas.

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT.

Observaciones

Esto puede producir elementos distintos que no estaban en el conjunto de fuentes original, incluidos los elementos con marcas de simulación (si fueran una coincidencia más cercana a la solicitud) e instancias que el autor de la fuente no denominaba. Los elementos de los mismos recursos de fuente se contraen en uno: la coincidencia más cercana posible.

Requisitos

Requisito	Valor
cliente mínimo admitido	Compilación 22621 de Windows 11
encabezado de	dwrite_3.h
biblioteca de	Dwrite.lib
DLL de	Dwrite.dll