Compartir a través de

Método IDWriteFontSetBuilder2::AddFont (dwrite_3.h)

  • Artículo

Agrega una fuente al conjunto que se está compilando, con el autor de la llamada proporcionando suficiente información para buscar y determinar los intervalos de ejes, evitando la necesidad de abrir la fuente potencialmente no local.

Sintaxis

HRESULT AddFont(
  IDWriteFontFile              *fontFile,
  UINT32                       fontFaceIndex,
  DWRITE_FONT_SIMULATIONS      fontSimulations,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
  UINT32                       fontAxisRangeCount,
  DWRITE_FONT_PROPERTY const   *properties,
  UINT32                       propertyCount
);

Parámetros

fontFile

Tipo: IDWriteFontFile de

Objeto de referencia de archivo de fuente que se va a agregar al conjunto.

fontFaceIndex

Tipo: UINT32

Índice de base cero de una cara de fuente en una colección.

fontSimulations

Tipo: DWRITE_FONT_SIMULATIONS

Marcas de simulación de caras de fuente para la embolia algorítmica y cursiva.

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.

fontAxisRanges

Tipo: DWRITE_FONT_AXIS_RANGE const *

Lista de intervalos de ejes.

fontAxisRangeCount

Tipo: UINT32

Número de intervalos de ejes.

properties

Tipo: DWRITE_FONT_PROPERTY const *

Lista de propiedades que se van a asociar a la referencia.

propertyCount

Tipo: UINT32

Número de propiedades definidas.

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

Las propiedades de fuente deben incluir al menos una familia (tipografía o peso/estilo/stretch). De lo contrario, la fuente sería accesible en el IDWriteFontSet solo por índice, no por nombre.

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