Struttura LOGFONTA (wingdi.h)
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
- JOHAB_CHARSET
- ARABIC_CHARSET
- HEBREW_CHARSET
- THAI_CHARSET
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
- FF_DECORATIVE
- FF_DONTCARE
- FF_MODERN
- FF_ROMAN
- FF_SCRIPT
- FF_SWISS
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) |