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.
HRESULT GetMatchingFonts(
DWRITE_FONT_PROPERTY const *fontProperty,
DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
UINT32 fontAxisValueCount,
IDWriteFontSet1 **matchingFonts
);
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
Número de valores de eje de fuentes contenidos en la matriz fontAxisValues.
matchingFonts
Tipo:
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
.
Si la función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT.
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.
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 |