Função AddFontResourceExA (wingdi.h)

A função AddFontResourceEx adiciona o recurso de fonte do arquivo especificado ao sistema. Fontes adicionadas com a função AddFontResourceEx podem ser marcadas como privadas e não enumeráveis.

Sintaxe

int AddFontResourceExA(
  [in] LPCSTR name,
  [in] DWORD  fl,
  [in] PVOID  res
);

Parâmetros

[in] name

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém um nome de arquivo de fonte válido. Esse parâmetro pode especificar qualquer um dos arquivos a seguir.

Extensão do arquivo	Significado
.Fon	Arquivo de recurso de fonte.
.Fnt	Arquivo de fonte de bitmap bruto.
.ttf	Arquivo TrueType bruto.
.Ttc	Windows do Leste Asiático: coleção de fontes TrueType.
.Fot	Arquivo de recurso TrueType.
.Otf	Fonte OpenType do PostScript.
.mmm	vários master arquivo de recurso de fonte Type1. Ele deve ser usado com arquivos .pfm e .pfb.
.Pfb	Digite um arquivo de bits de fonte. Ele é usado com um arquivo .pfm.
.Pfm	Digite um arquivo de métricas de fonte. Ele é usado com um arquivo .pfb.

 

Para adicionar uma fonte cujas informações vêm de vários arquivos de recurso, aponte lpszFileName para uma cadeia de caracteres com os nomes de arquivo separados por um | --por exemplo, abcxxxxx.pfm | abcxxxxx.pfb.

[in] fl

As características da fonte a ser adicionada ao sistema. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
FR_PRIVATE	Especifica que somente o processo que chamou a função AddFontResourceEx pode usar essa fonte. Quando o nome da fonte corresponder a uma fonte pública, a fonte privada será escolhida. Quando o processo for encerrado, o sistema removerá todas as fontes instaladas pelo processo com a função AddFontResourceEx .
FR_NOT_ENUM	Especifica que nenhum processo, incluindo o processo que chamou a função AddFontResourceEx , pode enumerar essa fonte.

[in] res

Reservado. Deve ser zero.

Retornar valor

Se a função for bem-sucedida, o valor retornado especificará o número de fontes adicionadas.

Se a função falhar, o valor retornado será zero. Nenhuma informação de erro estendida está disponível.

Comentários

Essa função permite que um processo use fontes sem permitir que outros processos acessem as fontes.

Quando um aplicativo não precisa mais de um recurso de fonte carregado chamando a função AddFontResourceEx , ele deve remover o recurso chamando a função RemoveFontResourceEx .

Essa função instala a fonte somente para a sessão atual. Quando o sistema for reiniciado, a fonte não estará presente. Para que a fonte seja instalada mesmo depois de reiniciar o sistema, a fonte deve ser listada no registro.

Uma fonte listada no registro e instalada em um local diferente da pasta %windir%\fonts\ não pode ser modificada, excluída ou substituída, desde que seja carregada em qualquer sessão. Para alterar uma dessas fontes, ela deve primeiro ser removida chamando RemoveFontResource, removida do registro de fonte (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts) e o sistema reiniciado. Depois de reiniciar o sistema, a fonte não será mais carregada e poderá ser alterada.

Observação

O cabeçalho wingdi.h define AddFontResourceEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll

Confira também

Funções de fonte e texto

Visão geral de fontes e texto

RemoveFontResourceEx

SendMessage