Struttura TEXTMETRICW (wingdi.h)
La struttura TEXTMETRIC
Sintassi
typedef struct tagTEXTMETRICW {
LONG tmHeight;
LONG tmAscent;
LONG tmDescent;
LONG tmInternalLeading;
LONG tmExternalLeading;
LONG tmAveCharWidth;
LONG tmMaxCharWidth;
LONG tmWeight;
LONG tmOverhang;
LONG tmDigitizedAspectX;
LONG tmDigitizedAspectY;
WCHAR tmFirstChar;
WCHAR tmLastChar;
WCHAR tmDefaultChar;
WCHAR tmBreakChar;
BYTE tmItalic;
BYTE tmUnderlined;
BYTE tmStruckOut;
BYTE tmPitchAndFamily;
BYTE tmCharSet;
} TEXTMETRICW, *PTEXTMETRICW, *NPTEXTMETRICW, *LPTEXTMETRICW;
Membri
tmHeight
Altezza (salita + discesa) di caratteri.
tmAscent
Salita (unità sopra la riga di base) di caratteri.
tmDescent
Discesa (unità sotto la riga di base) di caratteri.
tmInternalLeading
Quantità di spazio iniziale all'interno dei limiti impostati dal membro tmHeight. In questa area possono verificarsi segni accenti e altri caratteri diacritici. La finestra di progettazione può impostare questo membro su zero.
tmExternalLeading
Quantità di spazio iniziale aggiuntivo aggiunta dall'applicazione tra le righe. Poiché questa area è esterna al tipo di carattere, non contiene contrassegni e non viene modificata dalle chiamate di output di testo in modalità OPAQUE o TRANSPARENT. La finestra di progettazione può impostare questo membro su zero.
tmAveCharWidth
Larghezza media dei caratteri nel tipo di carattere (in genere definita come larghezza della lettera x ). Questo valore non include l'overhang necessario per i caratteri grassetto o corsivo.
tmMaxCharWidth
Larghezza del carattere più largo nel tipo di carattere.
tmWeight
Spessore del tipo di carattere.
tmOverhang
Larghezza aggiuntiva per stringa che può essere aggiunta ad alcuni tipi di carattere sintetizzati. Quando si sintetizzano alcuni attributi, ad esempio grassetto o corsivo, l'interfaccia GDI (Graphics Device Interface) o un dispositivo può dover aggiungere larghezza a una stringa sia per carattere che per stringa. Ad esempio, GDI rende una stringa in grassetto espandendo la spaziatura di ogni carattere e sovrastringa in base a un valore di offset; in corsivo un tipo di carattere eseguendo l'shearing della stringa. In entrambi i casi, è presente un overhang oltre la stringa di base. Per le stringhe in grassetto, l'overhang è la distanza di offset dell'overstrike. Per le stringhe in corsivo, l'overhang corrisponde alla quantità in cui la parte superiore del tipo di carattere viene esadesa oltre la parte inferiore del tipo di carattere.
Il membro tmOverhang
tmDigitizedAspectX
Aspetto orizzontale del dispositivo per il quale è stato progettato il tipo di carattere.
tmDigitizedAspectY
Aspetto verticale del dispositivo per il quale è stato progettato il tipo di carattere. Il rapporto tra i tmDigitizedAspectX e membri tmDigitizedAspectY corrisponde alle proporzioni del dispositivo per cui è stato progettato il tipo di carattere.
tmFirstChar
Valore del primo carattere definito nel tipo di carattere.
tmLastChar
Valore dell'ultimo carattere definito nel tipo di carattere.
tmDefaultChar
Valore del carattere da sostituire con i caratteri non presenti nel tipo di carattere.
tmBreakChar
Valore del carattere che verrà utilizzato per definire le interruzioni di parola per la giustificazione del testo.
tmItalic
Specifica un tipo di carattere corsivo se è diverso da zero.
tmUnderlined
Specifica un tipo di carattere sottolineato se è diverso da zero.
tmStruckOut
Tipo di carattere barrato se diverso da zero.
tmPitchAndFamily
Specifica informazioni sul passo, sulla tecnologia e sulla famiglia di un tipo di carattere fisico.
I quattro bit di basso ordine di questo membro specificano informazioni sul passo e sulla tecnologia del tipo di carattere. Viene definita una costante per ognuno dei quattro bit.
| Costante | Significato |
|---|---|
| TMPF_FIXED_PITCH | Se questo bit è impostato, il tipo di carattere è un tipo di carattere di passo variabile. Se questo bit è chiaro, il tipo di carattere è un tipo di carattere a passo fisso. Si noti con molta attenzione che questi significati sono l'opposto di ciò che implica il nome costante. |
| TMPF_VECTOR | Se questo bit è impostato, il tipo di carattere è un tipo di carattere vettoriale. |
| TMPF_TRUETYPE | Se questo bit è impostato, il tipo di carattere è TrueType. |
| TMPF_DEVICE | Se questo bit è impostato, il tipo di carattere è un tipo di carattere del dispositivo. |
Un'applicazione deve verificare attentamente le qualità codificate in questi bit di ordine ridotto, senza presupposti arbitrari. Ad esempio, oltre a impostare i propri bit, i tipi di carattere TrueType e PostScript impostano il bit di TMPF_VECTOR. Un tipo di carattere bitmap monospace ha tutti questi bit di ordine ridotto chiaro; un tipo di carattere bitmap proporzionale imposta il bit TMPF_FIXED_PITCH. Un tipo di carattere della stampante Postscript imposta i bit di TMPF_DEVICE, TMPF_VECTOR e TMPF_FIXED_PITCH.
I quattro bit alti di tmPitchAndFamily designano la famiglia di caratteri del tipo di carattere. Un'applicazione può usare il valore 0xF0 e l'operatore AND bit per bit per mascherare i quattro bit di ordine ridotto di tmPitchAndFamily, ottenendo così un valore che può essere confrontato direttamente con i nomi della famiglia di caratteri per trovare una corrispondenza identica. Per informazioni sulle famiglie di tipi di carattere, vedere la descrizione della struttura
tmCharSet
Set di caratteri del tipo di carattere. Il set di caratteri può essere uno dei valori seguenti.
- 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
Osservazioni
Nota
L'intestazione wingdi.h definisce TEXTMETRIC 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] |
| intestazione |
wingdi.h (include Windows.h) |
Vedere anche
strutture di tipo carattere e testo
panoramica tipi di carattere e testo