Struttura LOGFONTA (wingdi.h)

Articolo
03/11/2023

La struttura LOGFONT definisce gli attributi di un tipo di carattere.

Sintassi

typedef struct tagLOGFONTA {
  LONG lfHeight;
  LONG lfWidth;
  LONG lfEscapement;
  LONG lfOrientation;
  LONG lfWeight;
  BYTE lfItalic;
  BYTE lfUnderline;
  BYTE lfStrikeOut;
  BYTE lfCharSet;
  BYTE lfOutPrecision;
  BYTE lfClipPrecision;
  BYTE lfQuality;
  BYTE lfPitchAndFamily;
  CHAR lfFaceName[LF_FACESIZE];
} LOGFONTA, *PLOGFONTA, *NPLOGFONTA, *LPLOGFONTA;

Members

lfHeight

Altezza, in unità logiche, della cella o del carattere del carattere del tipo di carattere. Il valore dell'altezza del carattere (noto anche come altezza em) è il valore di altezza della cella di caratteri meno il valore interno-iniziale. Il mapper del carattere interpreta il valore specificato in lfHeight nel modo seguente.

Valore	Significato
> 0	Il mapper del tipo di carattere trasforma questo valore in unità dispositivo e lo corrisponde all'altezza della cella dei tipi di carattere disponibili.
0	Il mapper del tipo di carattere usa un valore di altezza predefinito quando cerca una corrispondenza.
< 0	Il mapper del carattere trasforma questo valore in unità dispositivo e corrisponde al valore assoluto rispetto all'altezza dei caratteri disponibili.

Per tutti i confronti di altezza, il mapper del carattere cerca il tipo di carattere più grande che non supera le dimensioni richieste.

Questo mapping si verifica quando il tipo di carattere viene usato per la prima volta.

Per la modalità di mapping MM_TEXT, è possibile usare la formula seguente per specificare un'altezza per un tipo di carattere con dimensioni del punto specificate:


lfHeight = -MulDiv(PointSize, GetDeviceCaps(hDC, LOGPIXELSY), 72);

lfWidth

Larghezza media, in unità logiche, di caratteri nel tipo di carattere. Se lfWidth è zero, il rapporto di aspetto del dispositivo viene confrontato con il rapporto di aspetto della digitalizzazione dei tipi di carattere disponibili per trovare la corrispondenza più vicina, determinata dal valore assoluto della differenza.

lfEscapement

Angolo, in decimi di gradi, tra il vettore di escape e l'asse x del dispositivo. Il vettore di escape è parallelo alla riga di base di una riga di testo.

Quando la modalità grafica è impostata su GM_ADVANCED, è possibile specificare l'angolo di escape della stringa indipendentemente dall'angolo di orientamento dei caratteri della stringa.

Quando la modalità grafica è impostata su GM_COMPATIBLE, lfEscapement specifica sia l'escape che l'orientamento. È necessario impostare lfEscapement e lfOrientation sullo stesso valore.

lfOrientation

L'angolo, in decimi di gradi, tra la linea di base di ogni carattere e l'asse x del dispositivo.

lfWeight

Peso del carattere nell'intervallo da 0 a 1000. Ad esempio, 400 è normale e 700 è grassetto. Se questo valore è zero, viene usato un peso predefinito.

I valori seguenti sono definiti per praticità.

Valore	Peso
FW_DONTCARE	0
FW_THIN	100
FW_EXTRALIGHT	200
FW_ULTRALIGHT	200
FW_LIGHT	300
FW_NORMAL	400
FW_REGULAR	400
FW_MEDIUM	500
FW_SEMIBOLD	600
FW_DEMIBOLD	600
FW_BOLD	700
FW_EXTRABOLD	800
FW_ULTRABOLD	800
FW_HEAVY	900
FW_BLACK	900

lfItalic

Tipo di carattere corsivo se impostato su TRUE.

lfUnderline

Tipo di carattere sottolineato se impostato su TRUE.

lfStrikeOut

Tipo di carattere di strikeout se impostato su TRUE.

lfCharSet

Set di caratteri. I valori seguenti sono predefiniti:

ANSI_CHARSET
BALTIC_CHARSET
CHINESEBIG5_CHARSET
DEFAULT_CHARSET
EASTEUROPE_CHARSET
GB2312_CHARSET
GREEK_CHARSET
HANGUL_CHARSET
MAC_CHARSET
OEM_CHARSET
RUSSIAN_CHARSET
SHIFTJIS_CHARSET
SYMBOL_CHARSET
TURKISH_CHARSET
VIETNAMESE_CHARSET

Edizione della lingua coreana di Windows:

JOHAB_CHARSET

Edizione del linguaggio Middle East di Windows:

ARABIC_CHARSET
HEBREW_CHARSET

Edizione della lingua thai di Windows:

THAI_CHARSET

Il valore OEM_CHARSET specifica un set di caratteri dipendente dal sistema operativo.

DEFAULT_CHARSET è impostato su un valore basato sulle impostazioni locali del sistema corrente. Ad esempio, quando le impostazioni locali di sistema sono inglese (Stati Uniti), viene impostata come ANSI_CHARSET.

I tipi di carattere con altri set di caratteri possono esistere nel sistema operativo. Se un'applicazione usa un tipo di carattere con un set di caratteri sconosciuto, non deve tentare di tradurre o interpretare le stringhe di cui viene eseguito il rendering con tale tipo di carattere.

Questo parametro è importante nel processo di mapping dei tipi di carattere. Per garantire risultati coerenti durante la creazione di un tipo di carattere, non specificare OEM_CHARSET o DEFAULT_CHARSET. Se si specifica un nome di carattere tipografico nel membro lfFaceName , assicurarsi che il valore lfCharSet corrisponda al set di caratteri del carattere tipografico specificato in lfFaceName.

lfOutPrecision

Precisione dell'output. La precisione di output definisce la precisione con cui l'output deve corrispondere all'altezza, alla larghezza, all'orientamento del carattere, all'orientamento del carattere, all'escape, al passo e al tipo di carattere richiesto. Può essere uno dei valori seguenti.

Valore	Significato
OUT_CHARACTER_PRECIS	Non usato.
OUT_DEFAULT_PRECIS	Specifica il comportamento predefinito del mapper del tipo di carattere.
OUT_DEVICE_PRECIS	Indica al mapper del tipo di carattere di scegliere un tipo di carattere Dispositivo quando il sistema contiene più tipi di carattere con lo stesso nome.
OUT_OUTLINE_PRECIS	Questo valore indica al mapper di tipi di carattere di scegliere tra TrueType e altri tipi di carattere basati sulla struttura.
OUT_PS_ONLY_PRECIS	Indica al mapper di tipi di carattere di scegliere solo i tipi di carattere PostScript. Se nel sistema non sono installati tipi di carattere PostScript, il mapper del tipo di carattere torna al comportamento predefinito.
OUT_RASTER_PRECIS	Indica al mapper del tipo di carattere di scegliere un tipo di carattere raster quando il sistema contiene più tipi di carattere con lo stesso nome.
OUT_STRING_PRECIS	Questo valore non viene utilizzato dal mapper del tipo di carattere, ma viene restituito quando vengono enumerati i tipi di carattere raster.
OUT_STROKE_PRECIS	Questo valore non viene utilizzato dal mapper dei tipi di carattere, ma viene restituito quando TrueType, altri tipi di carattere basati su struttura e tipi di carattere vettoriali vengono enumerati.
OUT_TT_ONLY_PRECIS	Indica al mapper di tipi di carattere di scegliere solo i tipi di carattere TrueType. Se nel sistema non sono installati tipi di carattere TrueType, il mapper del tipo di carattere torna al comportamento predefinito.
OUT_TT_PRECIS	Indica al mapper del tipo di carattere di scegliere un tipo di carattere TrueType quando il sistema contiene più tipi di carattere con lo stesso nome.

Le applicazioni possono utilizzare i valori OUT_DEVICE_PRECIS, OUT_RASTER_PRECIS, OUT_TT_PRECIS e OUT_PS_ONLY_PRECIS per controllare il modo in cui il mapper del carattere sceglie un tipo di carattere quando il sistema operativo contiene più tipi di carattere con un nome specificato. Ad esempio, se un sistema operativo contiene un tipo di carattere denominato Symbol in formato raster e TrueType, specificando OUT_TT_PRECIS forza il mapper del tipo di carattere a scegliere la versione TrueType. Se si specifica OUT_TT_ONLY_PRECIS forza il mapper del tipo di carattere a scegliere un tipo di carattere TrueType, anche se deve sostituire un tipo di carattere TrueType di un altro nome.

lfClipPrecision

Precisione di ritaglio. La precisione di ritaglio definisce come ritagliare i caratteri parzialmente esterni all'area di ritaglio. Può essere uno o più dei valori seguenti.

Per altre informazioni sull'orientamento dei sistemi di coordinate, vedere la descrizione del parametro nOrientation .

Valore	Significato
CLIP_CHARACTER_PRECIS	Non usato.
CLIP_DEFAULT_PRECIS	Specifica il comportamento di ritaglio predefinito.
CLIP_DFA_DISABLE	Windows XP SP1: Disattiva l'associazione dei tipi di carattere per il tipo di carattere. Si noti che questo flag non ha alcun effetto su qualsiasi piattaforma dopo Windows Server 2003.
CLIP_EMBEDDED	È necessario specificare questo flag per utilizzare un tipo di carattere di sola lettura incorporato.
CLIP_LH_ANGLES	Quando si utilizza questo valore, la rotazione per tutti i tipi di carattere dipende dal fatto che l'orientamento del sistema di coordinate sia sinistrorso o destrorso. Se non viene usato, i tipi di carattere del dispositivo ruotano sempre in senso antiorario, ma la rotazione di altri tipi di carattere dipende dall'orientamento del sistema di coordinate.
CLIP_MASK	Non usato.
CLIP_DFA_OVERRIDE	Disattiva l'associazione dei tipi di carattere per il tipo di carattere. Questo è identico a CLIP_DFA_DISABLE, ma può avere problemi in alcune situazioni; il flag consigliato da usare è CLIP_DFA_DISABLE.
CLIP_STROKE_PRECIS	Non utilizzato dal mapper del tipo di carattere, ma viene restituito quando vengono enumerati tipi di carattere raster, vector o TrueType. Per la compatibilità, questo valore viene sempre restituito durante l'enumerazione dei tipi di carattere.
CLIP_TT_ALWAYS	Non usato.

lfQuality

Qualità dell'output. La qualità dell'output definisce il modo in cui l'interfaccia GDI (Graphics Device Interface) deve tentare di associare gli attributi del tipo di carattere logico a quelli di un tipo di carattere fisico effettivo. Può essere uno dei valori seguenti.

Valore	Significato
ANTIALIASED_QUALITY	Il tipo di carattere è sempre antialiased se il tipo di carattere lo supporta e le dimensioni del carattere non sono troppo piccole o troppo grandi.
CLEARTYPE_QUALITY	Se impostato, il rendering del testo viene eseguito (quando possibile) usando il metodo anti-aliasing ClearType. Per ulteriori informazioni, vedere la sezione Osservazioni.
DEFAULT_QUALITY	L'aspetto del tipo di carattere non è rilevante.
DRAFT_QUALITY	L'aspetto del tipo di carattere è meno importante di quando si utilizza PROOF_QUALITY. Per i tipi di carattere raster GDI, la scalabilità è abilitata, il che significa che sono disponibili più dimensioni del carattere, ma la qualità potrebbe essere inferiore. I tipi di carattere grassetto, corsivo, sottolineato e barrato vengono sintetizzati, se necessario.
NONANTIALIASED_QUALITY	Il tipo di carattere non è mai antialiased.
PROOF_QUALITY	La qualità dei caratteri del tipo di carattere è più importante rispetto alla corrispondenza esatta degli attributi del tipo di carattere logico. Per i tipi di carattere raster GDI, il ridimensionamento è disabilitato e viene scelto il tipo di carattere più vicino alle dimensioni. Anche se la dimensione del carattere scelta potrebbe non essere mappata esattamente quando viene utilizzata PROOF_QUALITY, la qualità del tipo di carattere è elevata e non vi è alcuna distorsione dell'aspetto. I tipi di carattere grassetto, corsivo, sottolineato e barrato vengono sintetizzati, se necessario.

Se non è selezionata né ANTIALIASED_QUALITY né NONANTIALIASED_QUALITY, il tipo di carattere viene antialiased solo se l'utente sceglie tipi di carattere dello schermo smussati in Pannello di controllo.

lfPitchAndFamily

Passo e famiglia del tipo di carattere. I due bit di ordine basso specificano l'inclinazione del tipo di carattere e possono essere uno dei valori seguenti.

DEFAULT_PITCH
FIXED_PITCH
VARIABLE_PITCH

I bit da 4 a 7 del membro specificano la famiglia di caratteri e possono essere uno dei valori seguenti.

FF_DECORATIVE
FF_DONTCARE
FF_MODERN
FF_ROMAN
FF_SCRIPT
FF_SWISS

Il valore corretto può essere ottenuto usando l'operatore OR booleano per unire una costante di passo con una costante della famiglia.

Le famiglie di caratteri descrivono l'aspetto di un tipo di carattere in modo generale. Sono destinati a specificare i tipi di carattere quando l'esatto carattere tipografico desiderato non è disponibile. I valori per le famiglie di caratteri sono i seguenti.

Valore	Significato
FF_DECORATIVE	Tipi di carattere novità. Un esempio è Old English.
FF_DONTCARE	Usare il tipo di carattere predefinito.
FF_MODERN	Tipi di carattere con larghezza del tratto costante (monospace), con o senza serifs. I tipi di carattere Monospace sono in genere moderni. Pica, Elite e CourierNew sono esempi.
FF_ROMAN	Tipi di carattere con larghezza del tratto variabile (proporzionale) e con serifs. Un esempio è MS Serif.
FF_SCRIPT	Tipi di carattere progettati per essere simili alla grafia. Esempi sono Script e Cursive.
FF_SWISS	Tipi di carattere con larghezza del tratto variabile (proporzionale) e senza serifs. Un esempio è MS Sans Serif.

lfFaceName[LF_FACESIZE]

Stringa con terminazione Null che specifica il nome del carattere. La lunghezza di questa stringa non deve superare i 32 valori TCHAR , inclusi i valori NULL terminanti. La funzione EnumFontFamiliesEx può essere usata per enumerare i nomi di carattere tipizzato di tutti i tipi di carattere attualmente disponibili. Se lfFaceName è una stringa vuota, GDI usa il primo tipo di carattere corrispondente agli altri attributi specificati.

Commenti

Le situazioni seguenti non supportano l'antialiasing ClearType:

Il rendering del testo viene eseguito su una stampante.
Visualizzazione impostata per 256 colori o meno.
Il rendering del testo viene eseguito in un client del server terminale.
Il carattere non è un carattere TrueType o un tipo di carattere OpenType con contorni TrueType. Ad esempio, le seguenti non supportano l'antialiasing ClearType: tipi di carattere 1, tipi di carattere OpenType postscript senza contorni TrueType, tipi di carattere bitmap, tipi di carattere vettoriale e tipi di carattere del dispositivo.
Il tipo di carattere ha ottimizzato le bitmap incorporate, per qualsiasi dimensione del tipo di carattere che contiene le bitmap incorporate. Ad esempio, questo si verifica comunemente nei tipi di carattere asiatici orientali.

Nota

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


Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Intestazione	wingdi.h (include Windows.h)

Vedi anche

CreateFont

CreateFontIndirect

EnumFontFamiliesEx

Strutture carattere e testo

Panoramica dei tipi di carattere e del testo