Funzione AddFontResourceW (wingdi.h)
La funzione AddFontResource aggiunge la risorsa tipo di carattere dal file specificato alla tabella dei tipi di carattere di sistema. Il tipo di carattere può essere utilizzato successivamente per l'output di testo da qualsiasi applicazione.
Per contrassegnare un tipo di carattere come privato o non enumerabile, utilizzare la funzione AddFontResourceEx .
Sintassi
int AddFontResourceW(
[in] LPCWSTR 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.
Per aggiungere un tipo di carattere le cui informazioni provengono da diversi file di risorse, impostare lpszFileName su 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 estese sull'errore.
Commenti
Qualsiasi applicazione che aggiunge o rimuove i tipi di carattere dalla tabella dei tipi di carattere di sistema deve notificare ad altre finestre della modifica inviando un messaggio di WM_FONTCHANGE a tutte le finestre di primo livello del 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 del tipo 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. Al riavvio del sistema, 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 un percorso diverso dalla cartella %windir%\fonts\ non può essere modificato, eliminato o sostituito purché venga caricato in qualsiasi sessione. Per modificare uno di questi tipi di carattere, è necessario prima rimuoverlo chiamando RemoveFontResource, rimosso dal Registro di sistema 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 potrà 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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
Funzioni per tipi di carattere e testo