Compartilhar via

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

  • Artigo

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

Requisito Valor
de cliente com suporte mínimo Windows 10 Build 16299
servidor com suporte mínimo Windows 10 Build 16299
da Plataforma de Destino Windows
cabeçalho dwrite_3.h
biblioteca Dwrite.lib