Funzione EnumFontFamiliesA (wingdi.h)
La funzione EnumFontFamilies enumera i tipi di carattere in una famiglia di caratteri specificata disponibile in un dispositivo specificato.
Sintassi
int EnumFontFamiliesA(
[in] HDC hdc,
[in] LPCSTR lpLogfont,
[in] FONTENUMPROCA lpProc,
[in] LPARAM lParam
);
Parametri
[in] hdc
Handle al contesto del dispositivo da cui enumerare i tipi di carattere.
[in] lpLogfont
Puntatore a una stringa con terminazione null che specifica il nome della famiglia dei tipi di carattere desiderati. Se lpszFamily è NULL, EnumFontFamilies seleziona ed enumera un tipo di carattere di ogni famiglia di tipi disponibile.
[in] lpProc
Puntatore alla funzione di callback definita dall'applicazione. Per informazioni, vedere EnumFontFamProc.
[in] lParam
Puntatore ai dati forniti dall'applicazione. I dati vengono passati alla funzione callback insieme alle informazioni sul tipo di carattere.
Valore restituito
Il valore restituito è l'ultimo valore restituito dalla funzione callback. Il suo significato è l'implementazione specifica.
Commenti
Per ogni carattere con il nome di carattere specificato dal parametro lpszFamily , la funzione EnumFontFamilies recupera informazioni sul tipo di carattere e lo passa alla funzione puntata dal parametro lpEnumFontFamProc . La funzione di callback definita dall'applicazione può elaborare le informazioni sul tipo di carattere in base alle esigenze. L'enumerazione continua fino a quando non sono presenti più tipi di carattere o la funzione di callback restituisce zero.
Quando la modalità grafica nel contesto del dispositivo è impostata su GM_ADVANCED usando la funzione SetGraphicsMode e il flag di DEVICE_FONTTYPE viene passato al parametro FontType, questa funzione restituisce un elenco di tipi 1 e tipi di carattere OpenType nel sistema. Quando la modalità grafica non è impostata su GM_ADVANCED, questa funzione restituisce un elenco di tipi 1, OpenType e tipi di carattere TrueType nel sistema.
I tipi di carattere per molte lingue asiatiche orientali hanno due nomi tipizzati: un nome inglese e un nome localizzato. EnumFonts,EnumFontFamilies e EnumFontFamiliesEx restituiscono il nome del carattere di tipo inglese se le impostazioni locali del sistema non corrispondono alla lingua del tipo di carattere.
Esempio
Per esempi, vedere Enumerazione dei tipi di carattere installati.
Nota
L'intestazione wingdi.h definisce EnumFontFamilies 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
| Requisito | Valore |
|---|---|
| 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 |