Funzione CreateFontIndirectExA (wingdi.h)

Articolo
03/08/2023

La funzione CreateFontIndirectEx specifica un tipo di carattere logico con le caratteristiche nella struttura specificata. Il tipo di carattere può essere successivamente selezionato come tipo di carattere corrente per qualsiasi contesto di dispositivo.

Sintassi

HFONT CreateFontIndirectExA(
  [in] const ENUMLOGFONTEXDVA *unnamedParam1
);

Parametri

[in] unnamedParam1

Puntatore a una struttura ENUMLOGFONTEXDV che definisce le caratteristiche di un tipo di carattere master multiplo.

Si noti che questa funzione ignora il membro elfDesignVector in ENUMLOGFONTEXDV.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è l'handle per la nuova struttura ENUMLOGFONTEXDV .

Se la funzione ha esito negativo, il valore restituito è zero. Non sono disponibili informazioni estese sull'errore.

Commenti

La funzione CreateFontIndirectEx crea un tipo di carattere logico con le caratteristiche specificate nella struttura ENUMLOGFONTEXDV . Quando questo tipo di carattere viene selezionato utilizzando la funzione SelectObject , il mapper del tipo di carattere di GDI tenta di corrispondere al tipo di carattere logico con un tipo di carattere fisico esistente. Se non riesce a trovare una corrispondenza esatta, fornisce un'alternativa le cui caratteristiche corrispondono al maggior numero possibile di caratteristiche richieste.

Quando il tipo di carattere non è più necessario, chiamare la funzione DeleteObject per eliminarlo.

Il mapper del tipo di carattere per CreateFont, CreateFontIndirect e CreateFontIndirectEx riconosce sia l'inglese che il nome del carattere tipografico localizzato, indipendentemente dalle impostazioni locali.

Nota

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