Funzione AddFontResourceExW (wingdi.h)

  • Articolo

La funzione AddFontResourceEx aggiunge la risorsa del tipo di carattere dal file specificato al sistema. I tipi di carattere aggiunti con la funzione AddFontResourceEx possono essere contrassegnati come privati e non enumerabili.

Sintassi

int AddFontResourceExW(
  [in] LPCWSTR name,
  [in] DWORD   fl,
  [in] PVOID   res
);

Parametri

[in] name

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 asiatico orientale: raccolta di tipi di carattere TrueType.
.Uft
 File di risorse TrueType.
.Otf
 Tipo di carattere OpenType PostScript.
.Mmm
 più file di risorse tipo di carattere master Type1. Deve essere usato con i file pfm e pfb.
.Pfb
 Digitare 1 file di bit del tipo di carattere. Viene usato con un file con estensione pfm.
.Pfm
 Digitare 1 file di metriche del tipo di carattere. Viene usato con un file con estensione pfb.
 

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

[in] fl

Caratteristiche del tipo di carattere da aggiungere al sistema. Questo parametro può avere uno dei valori seguenti.

Valore Significato
FR_PRIVATE
 Specifica che solo il processo che ha chiamato la funzione AddFontResourceEx può utilizzare questo tipo di carattere. Quando il nome del carattere corrisponde a un tipo di carattere pubblico, verrà scelto il tipo di carattere privato. Al termine del processo, il sistema rimuoverà tutti i tipi di carattere installati dal processo con la funzione AddFontResourceEx .
FR_NOT_ENUM
 Specifica che nessun processo, incluso il processo che ha chiamato la funzione AddFontResourceEx , può enumerare questo tipo di carattere.

[in] res

Riservato. Deve essere zero.

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

Questa funzione consente a un processo di usare i tipi di carattere senza consentire ad altri processi di accedere ai tipi di carattere.

Quando un'applicazione non necessita più di una risorsa del tipo di carattere caricata chiamando la funzione AddFontResourceEx , deve rimuovere la risorsa chiamando la funzione RemoveFontResourceEx .

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 AddFontResourceEx 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

Cenni preliminari su tipi di carattere e testo

RemoveFontResourceEx

SendMessage