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 detecção facial de fonte para incentivo algoritmo e itálico.

fontAxisValues

Tipo: DWRITE_FONT_AXIS_VALUE const *

Um ponteiro para uma matriz que contém uma lista de valores do eixo da 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 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 retornado

Tipo: HRESULT

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

Comentários

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

Requisitos

Cliente mínimo com suporte	Windows 10 Build 20348
Servidor mínimo com suporte	Windows 10 Build 20348
Plataforma de Destino	Windows
Cabeçalho	dwrite_3.h
Biblioteca	Dwrite.lib