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

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

Sintaxis

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 *

Propiedad font de interés, como familia tipográfica o familia de peso/stretch/style.

fontAxisValues

Tipo: DWRITE_FONT_AXIS_VALUE const *

Puntero a una matriz que contiene una lista de valores de eje de fuentes. La matriz debe ser el tamaño (el número de elementos) indicado por el argumento fontAxisValueCount.

fontAxisValueCount

Tipo: UINT32

Número de valores de eje de fuentes contenidos en la matriz fontAxisValues.

matchingFonts

Tipo: IDWriteFontSet1

Dirección de un puntero a una interfaz IDWriteFontSet1. Al finalizar correctamente, la función establece el puntero en una lista prioritaria de fuentes que coinciden con las propiedades; de lo contrario, establece el puntero en nullptr.

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

Este método 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 fuentes no denominaron. 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 16299 de Windows 10
servidor mínimo admitido	Compilación 16299 de Windows 10
de la plataforma de destino de	Windows
encabezado de	dwrite_3.h
biblioteca de	Dwrite.lib