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

Adiciona uma fonte ao conjunto que está sendo criado, com o chamador fornecendo informações suficientes para pesquisar e determinar intervalos de eixo, evitando a necessidade de abrir a fonte potencialmente não local.

Sintaxe

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

Objeto de referência de arquivo de fonte a ser adicionado ao conjunto.

fontFaceIndex

Tipo: UINT32

O índice baseado em zero de uma face de fonte em uma coleção.

fontSimulations

Tipo: DWRITE_FONT_SIMULATIONS

Sinalizadores de simulação de rosto de fonte para incentivo e itálico algorítmico.

fontAxisValues

Tipo: DWRITE_FONT_AXIS_VALUE const *

Um ponteiro para uma matriz que contém uma lista de valores de eixo de fonte. A matriz deve ser o tamanho (o número de elementos) indicado pelo argumento fontAxisValueCount.

fontAxisValueCount

Tipo: UINT32

O número de valores de eixo de fonte contidos na matriz de fontAxisValues.

fontAxisRanges

Tipo: DWRITE_FONT_AXIS_RANGE const *

Lista de intervalos de eixos.

fontAxisRangeCount

Tipo: UINT32

Número de intervalos de eixos.

properties

Tipo: DWRITE_FONT_PROPERTY const *

Lista de propriedades a serem associadas à referência.

propertyCount

Tipo: UINT32

O número de propriedades definidas.

Valor de retorno

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um de código de erro HRESULT.

Observações

As propriedades da fonte devem incluir pelo menos uma família (tipográfico ou peso/estilo/alongamento). Caso contrário, a fonte estaria acessível no IDWriteFontSet apenas por índice, não pelo nome.

Requisitos