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ò avere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Il tipo di carattere dispone dell'autorizzazione di lettura/scrittura. |
|
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
Commenti
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 carattere TrueType (in genere con estensione 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 della tecnologia TrueType.
Quando il parametro lpszFontFile specifica solo un nome 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'estensione e viene specificato un percorso nel parametro lpszCurrentPath , la stringa in lpszFontFile viene copiata nel file con estensione fot come file con estensione ttf appartenente a questa risorsa. Quando viene chiamata la funzione AddFontResource , il sistema operativo presuppone che il file con estensione ttf sia stato copiato nella directory di sistema (o nella directory principale di Windows nel caso di un'installazione di rete). Il file con estensione 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 viene specificato 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 con estensione ttf deve trovarsi nel percorso specificato nel parametro lpszFontFile quando è stata chiamata la funzione CreateScalableFontResource ; il parametro lpszCurrentPath non è necessario. Una risorsa creata in questo modo contiene riferimenti assoluti a percorsi e unità e non funziona se il file con estensione 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 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 |