Compartilhar via


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

Cria uma referência a um recurso de arquivo de fonte específico do aplicativo.

Sintaxe

HRESULT CreateCustomFontFileReference(
  [in]  void const            *fontFileReferenceKey,
        UINT32                fontFileReferenceKeySize,
        IDWriteFontFileLoader *fontFileLoader,
  [out] IDWriteFontFile       **fontFile
);

Parâmetros

[in] fontFileReferenceKey

Tipo: const void*

Uma chave de referência de arquivo de fonte que identifica exclusivamente o recurso de arquivo de fonte durante o tempo de vida de fontFileLoader.

fontFileReferenceKeySize

Tipo: UINT32

O tamanho da chave de referência do arquivo de fonte em bytes.

fontFileLoader

Tipo: IDWriteFontFileLoader*

O carregador de arquivo de fonte que será usado pelo sistema de fontes para carregar dados do arquivo identificado por fontFileReferenceKey.

[out] fontFile

Tipo: IDWriteFontFile**

Contém um endereço de um ponteiro para o objeto de arquivo de fonte recém-criado quando esse método é bem-sucedido 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.

Comentários

Essa função é fornecida para casos em que um aplicativo ou um documento precisa usar uma fonte privada sem precisar instalá-la no sistema. fontFileReferenceKey deve ser exclusivo somente no escopo da fonteFileLoader usada nesta chamada.

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 Atualização de Plataforma 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