Funzione EnumFontsA (wingdi.h)

Articolo
11/20/2024

La funzione EnumFonts enumera i tipi di carattere disponibili in un dispositivo specificato. Per ogni tipo di carattere con il nome del carattere tipografico specificato, la funzione EnumFonts recupera informazioni sul tipo di carattere e la passa alla funzione di callback definita dall'applicazione. Questa funzione di callback 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.

Nota Questa funzione viene fornita solo per compatibilità con le versioni a 16 bit di Windows. Le applicazioni devono usare la funzione EnumFontFamiliesEx .

Sintassi

int EnumFontsA(
  [in] HDC           hdc,
  [in] LPCSTR        lpLogfont,
  [in] FONTENUMPROCA lpProc,
  [in] LPARAM        lParam
);

Parametri

[in] hdc

Handle per il contesto di dispositivo da cui enumerare i tipi di carattere.

[in] lpLogfont

Puntatore a una stringa con terminazione Null che specifica il nome del carattere tipografico dei tipi di carattere desiderati. Se lpFaceName è NULL, EnumFonts seleziona ed enumera casualmente un tipo di carattere di ogni carattere tipografico disponibile.

[in] lpProc

Puntatore alla funzione definita dall'applicazionecallback. Per altre informazioni, vedere EnumFontsProc.

[in] lParam

Puntatore a qualsiasi dato definito dall'applicazione. I dati vengono passati alla funzione di callback insieme alle informazioni sul tipo di carattere.

Valore restituito

Il valore restituito è l'ultimo valore restituito dalla funzione di callback. Il suo significato è definito dall'applicazione.

Osservazioni

Usare EnumFontFamiliesEx anziché EnumFonts. La funzione EnumFontFamiliesEx differisce dalla funzione EnumFonts in quanto recupera i nomi di stile associati a un tipo di carattere TrueType. Con EnumFontFamiliesEx, è possibile recuperare informazioni sugli stili dei tipi di carattere che non possono essere enumerati usando la funzione EnumFonts.

I tipi di carattere per molte lingue dell'Asia orientale hanno due nomi di carattere tipografico: un nome inglese e un nome localizzato. EnumFonts, EnumFontFamiliese EnumFontFamiliesEx restituiscono il nome del carattere tipografico inglese se le impostazioni locali di sistema non corrispondono alla lingua del tipo di carattere.

Nota

L'intestazione wingdi.h definisce EnumFonts 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