Funzione CreateScalableFontResourceA (wingdi.h)

[La funzione CreateScalableFontResource è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere

modificato o non disponibile nelle versioni successive.]

La funzione CreateScalableFontResource crea un file di risorse del tipo di carattere per un tipo di carattere scalabile.

Sintassi

BOOL CreateScalableFontResourceA(
  [in] DWORD  fdwHidden,
  [in] LPCSTR lpszFont,
  [in] LPCSTR lpszFile,
  [in] LPCSTR lpszPath
);

Parametri

[in] fdwHidden

Specifica se il tipo di carattere è di sola lettura. Questo parametro può essere uno dei valori seguenti.

Valore	Significato
0	Il tipo di carattere dispone dell'autorizzazione di lettura/scrittura.
1	Il tipo di carattere dispone dell'autorizzazione di sola lettura e deve essere nascosto da altre applicazioni nel sistema. Quando questo flag è impostato, il tipo di carattere non viene enumerato dalla funzione EnumFonts o EnumFontFamilies.

[in] lpszFont

Puntatore a una stringa con terminazione Null che specifica il nome del file di risorse del tipo di carattere da creare. Se questo parametro specifica un file di risorse del tipo di carattere esistente, la funzione ha esito negativo.

[in] lpszFile

Puntatore a una stringa con terminazione Null che specifica il nome del file di carattere scalabile usato da questa funzione per creare il file di risorse del tipo di carattere.

[in] lpszPath

Puntatore a una stringa con terminazione Null che specifica il percorso del file di carattere scalabile.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Se lpszFontRes specifica un file di tipo di carattere esistente, GetLastError restituisce ERROR_FILE_EXISTS

Osservazioni

La funzione CreateScalableFontResource viene usata dalle applicazioni che installano tipi di carattere TrueType. Un'applicazione usa la funzione CreateScalableFontResource per creare un file di risorse del tipo di carattere (in genere con estensione fot) e quindi usa la funzione AddFontResource per installare il tipo di carattere. Il file di tipo di carattere TrueType (in genere con estensione di file .ttf) deve trovarsi nella sottodirectory System della directory di Windows da utilizzare dalla funzione AddFontResource.

La funzione CreateScalableFontResource supporta attualmente solo tipi di carattere scalabili con tecnologia TrueType.

Quando il parametro lpszFontFile specifica solo un nome di file e un'estensione, il parametro lpszCurrentPath deve specificare un percorso. Quando il parametro lpszFontFile specifica un percorso completo, il parametro lpszCurrentPath deve essere NULL o un puntatore a NULL.

Quando nel parametro lpszFontFile viene specificato solo un nome di file e un percorso viene specificato nel parametro lpszCurrentPath, la stringa in lpszFontFile viene copiata nel file fot come file .ttf appartenente a questa risorsa. Quando viene chiamata la funzione addFontResource , il sistema operativo presuppone che il file .ttf sia stato copiato nella directory di sistema (o nella directory principale di Windows nel caso di un'installazione di rete). Il file .ttf non deve trovarsi in questa directory quando viene chiamata la funzione createScalableFontResource, perché il parametro lpszCurrentPath contiene le informazioni sulla directory. Una risorsa creata in questo modo non contiene informazioni sul percorso assoluto e può essere usata in qualsiasi installazione.

Quando si specifica un percorso nel parametro lpszFontFile e NULL viene specificato nel parametro lpszCurrentPath, la stringa in lpszFontFile viene copiata nel file fot. In questo caso, quando viene chiamata la funzione AddFontResource , il file .ttf deve trovarsi nel percorso specificato nel parametro lpszFontFile quando è stata chiamata la funzione CreateScalableFontResource; non è necessario il parametro lpszCurrentPath . Una risorsa creata in questo modo contiene riferimenti assoluti a percorsi e unità e non funziona se il file .ttf viene spostato in un percorso diverso.

Nota

L'intestazione wingdi.h definisce CreateScalableFontResource 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wingdi.h (include Windows.h)
libreria	Gdi32.lib
dll	Gdi32.dll

Vedere anche

AddFontResource

EnumFontFamilies

EnumFonts

funzioni di tipo carattere e testo

panoramica tipi di carattere e testo