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

Recupera una lista de fuentes de la familia de fuentes especificada, clasificada en orden de coincidencia con los valores de eje especificados.

Sintaxis

HRESULT GetMatchingFonts(
        WCHAR const                  *familyName,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontList2             **fontList
);

Parámetros

familyName

Tipo: WCHAR const *

Nombre de la familia de fuentes. El nombre no distingue mayúsculas de minúsculas, pero debe coincidir exactamente con un nombre de familia de la colección.

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.

[out] fontList

Tipo: IDWriteFontList2 de

Dirección de un puntero a una interfaz de IDWriteFontList2. Al finalizar correctamente, la función establece el puntero en un objeto de lista de fuentes recién creado.

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

Si no coinciden fuentes, se devuelve un objeto de lista vacío (llamando a IDWriteFontList::GetFontCount en él devuelve 0), pero la función no devuelve un error.

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