Compartilhar via


Método IDWriteFactory6::CreateFontFaceReference (dwrite_3.h)

Cria uma referência a uma instância de fonte específica em um arquivo.

Sintaxe

HRESULT CreateFontFaceReference(
        IDWriteFontFile              *fontFile,
        UINT32                       faceIndex,
        DWRITE_FONT_SIMULATIONS      fontSimulations,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontFaceReference1    **fontFaceReference
);

Parâmetros

fontFile

Tipo: * IDWriteFontFile

Um arquivo de fonte fornecido pelo usuário que representa a face da fonte.

faceIndex

Tipo: UINT32

O índice baseado em zero de uma face de fonte em casos em que o arquivo de fonte contém uma coleção de faces de fonte. Se o arquivo de fonte contiver uma única face, defina esse valor como zero.

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.

[out] fontFaceReference

Tipo: IDWriteFontFaceReference1**

O endereço de um ponteiro para uma interface IDWriteFontFaceReference1 . Após a conclusão bem-sucedida, a função define o ponteiro para um objeto de referência de rosto de fonte recém-criado, caso contrário, define o ponteiro como nullptr.

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.

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