Funzione EnumFontFamiliesA (wingdi.h)

Articolo
08/27/2023

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