Método IDWriteFactory::CreateFontFace (dwrite.h)

Artigo
08/23/2023

Cria um objeto que representa uma face de fonte.

Sintaxe

HRESULT CreateFontFace(
        DWRITE_FONT_FACE_TYPE   fontFaceType,
        UINT32                  numberOfFiles,
  [in]  IDWriteFontFile         * const *fontFiles,
        UINT32                  faceIndex,
        DWRITE_FONT_SIMULATIONS fontFaceSimulationFlags,
  [out] IDWriteFontFace         **fontFace
);

Parâmetros

fontFaceType

Tipo: DWRITE_FONT_FACE_TYPE

Um valor que indica o tipo de formato de arquivo da face da fonte.

numberOfFiles

Tipo: UINT32

O número de arquivos de fonte, na contagem de elementos, necessário para representar a face da fonte.

[in] fontFiles

Tipo: const IDWriteFontFile*

Um objeto de arquivo de fonte que representa a face da fonte. Como IDWriteFontFace mantém suas próprias referências aos objetos de arquivo de fonte de entrada, você pode liberá-los após essa chamada.

faceIndex

Tipo: UINT32

O índice baseado em zero de uma face de fonte, em casos em que os arquivos de fonte contêm uma coleção de faces de fonte. Se os arquivos de fonte contiverem uma única face, esse valor deverá ser zero.

fontFaceSimulationFlags

Tipo: DWRITE_FONT_SIMULATIONS

Um valor que indica quais sinalizadores de simulação de face de fonte, se houver, para meios algorítmicos de tornar o texto em negrito ou itálico são aplicados à face da fonte atual.

[out] fontFace

Tipo: IDWriteFontFace**

Quando esse método retorna, contém um endereço de um ponteiro para o objeto de face de fonte recém-criado ou NULL em caso de falha.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos


Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	dwrite.h
Biblioteca	Dwrite.lib
DLL	Dwrite.dll

Confira também

IDWriteFactory

Share via