Funzione EnumFontsA (wingdi.h)

Articolo
03/04/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 finché non sono presenti più tipi di carattere o la funzione di callback restituisce zero.

Nota Questa funzione viene fornita solo per la 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 in modo casuale ed enumera 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 tutti i dati definiti 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.

Commenti

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, EnumFontFamilies e EnumFontFamiliesEx restituiscono il nome del carattere tipografico inglese se le impostazioni locali del 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 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

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