Função AddFontResourceA (wingdi.h)

  • Artigo

A função AddFontResource adiciona o recurso de fonte do arquivo especificado à tabela de fontes do sistema. Posteriormente, a fonte pode ser usada para saída de texto por qualquer aplicativo.

Para marcar uma fonte como privada ou não enumerável, use a função AddFontResourceEx .

Sintaxe

int AddFontResourceA(
  [in] LPCSTR unnamedParam1
);

Parâmetros

[in] unnamedParam1

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
 East Asian Windows: 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 1 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, tenha lpszFileName apontar para uma cadeia de caracteres com os nomes de arquivo separados por um "|" --por exemplo, abcxxxxx.pfm | abcxxxxx.pfb.

Valor retornado

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

Qualquer aplicativo que adicione ou remova fontes da tabela de fontes do sistema deve notificar outras janelas da alteração enviando uma mensagem de WM_FONTCHANGE para todas as janelas de nível superior no sistema operacional. O aplicativo deve enviar essa mensagem chamando a função SendMessage e definindo o parâmetro hwnd como HWND_BROADCAST.

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

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, primeiro ele deve ser removido chamando RemoveFontResource, removido 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 AddFontResource 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

   
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

AddFontResourceEx

Funções de fonte e texto

Visão geral de fontes e texto

RemoveFontResource

SendMessage