Funzione AddFontResourceA (wingdi.h)

La funzione AddFontResource aggiunge la risorsa carattere dal file specificato alla tabella dei caratteri di sistema. Il tipo di carattere può essere usato successivamente per l'output di testo da qualsiasi applicazione.

Per contrassegnare un tipo di carattere come privato o non enumerabile, usare la funzione AddFontResourceEx .

Sintassi

int AddFontResourceA(
  [in] LPCSTR unnamedParam1
);

Parametri

[in] unnamedParam1

Puntatore a una stringa di caratteri con terminazione null contenente un nome di file di carattere valido. Questo parametro può specificare uno dei file seguenti.

Estensione nome del file	Significato
.Fon	File di risorse del tipo di carattere.
.Fnt	File di carattere bitmap non elaborato.
.ttf	File TrueType non elaborato.
.Ttc	Windows asiatici orientali: raccolta di caratteri TrueType.
.Uft	File di risorse TrueType.
.Otf	Tipo di carattere OpenType PostScript.
.Mmm	Più file di risorse del tipo di carattere master Type1. Deve essere usato con file pfm e pfb.
.Pfb	Digitare 1 file di bit di carattere. Viene usato con un file pfm.
.Pfm	Tipo 1 file di metriche del tipo di carattere. Viene usato con un file pfb.

 

Per aggiungere un tipo di carattere le cui informazioni provengono da diversi file di risorse, avere lpszFileName puntare a una stringa con i nomi di file separati da un file "|" --ad esempio abcxxxxx.pfm | abcxxxxx.pfb.

Valore restituito

Se la funzione ha esito positivo, il valore restituito specifica il numero di tipi di carattere aggiunti.

Se la funzione ha esito negativo, il valore restituito è zero. Non sono disponibili informazioni di errore estese.

Commenti

Qualsiasi applicazione che aggiunge o rimuove i tipi di carattere dalla tabella dei tipi di carattere di sistema deve notificare altre finestre della modifica inviando un messaggio di WM_FONTCHANGE a tutte le finestre di primo livello nel sistema operativo. L'applicazione deve inviare questo messaggio chiamando la funzione SendMessage e impostando il parametro hwnd su HWND_BROADCAST.

Quando un'applicazione non necessita più di una risorsa di carattere caricata chiamando la funzione AddFontResource , deve rimuovere tale risorsa chiamando la funzione RemoveFontResource .

Questa funzione installa il tipo di carattere solo per la sessione corrente. Quando il sistema viene riavviato, il tipo di carattere non sarà presente. Per avere installato il tipo di carattere anche dopo il riavvio del sistema, il tipo di carattere deve essere elencato nel Registro di sistema.

Un tipo di carattere elencato nel Registro di sistema e installato in una posizione diversa dalla cartella %windir%\font\ non può essere modificata, eliminata o sostituita finché viene caricata in qualsiasi sessione. Per modificare uno di questi tipi di carattere, deve prima essere rimosso chiamando RemoveFontResource, rimosso dal registro dei tipi di carattere (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts) e riavviato il sistema. Dopo il riavvio del sistema, il tipo di carattere non verrà più caricato e può essere modificato.

Nota

L'intestazione wingdi.h definisce AddFontResource come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll

Vedi anche

AddFontResourceEx

Funzioni carattere e testo

Panoramica dei tipi di carattere e del testo

RemoveFontResource

SendMessage