Funzione EnumFontFamiliesA (wingdi.h)

Articolo
11/20/2024

La funzione EnumFontFamilies enumera i tipi di carattere in una famiglia di caratteri specificata disponibile in un dispositivo specificato.

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 EnumFontFamiliesA(
  [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 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 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 è specifico dell'implementazione.

Osservazioni

Per ogni tipo di carattere con il nome del carattere tipografico specificato dal parametro lpszFamily, la funzione EnumFontFamilies recupera informazioni sul tipo di carattere e la passa alla funzione a cui punta il 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 di dispositivo è impostata su GM_ADVANCED utilizzando la funzione SetGraphicsMode e il flag DEVICE_FONTTYPE viene passato al parametro FontType, questa funzione restituisce un elenco di tipi di carattere di tipo 1 e OpenType nel sistema. Quando la modalità grafica non è impostata su GM_ADVANCED, questa funzione restituisce un elenco di tipi di carattere di tipo 1, OpenType e TrueType nel sistema.

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.

Esempi

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 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