Structure TEXTMETRICW (wingdi.h)
La structure TEXTMETRIC
Syntaxe
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;
Membres
tmHeight
Hauteur (ascension + descente) des caractères.
tmAscent
Ascension (unités au-dessus de la ligne de base) des caractères.
tmDescent
Descente (unités situées en dessous de la ligne de base) des caractères.
tmInternalLeading
Quantité de début (espace) à l’intérieur des limites définies par le membre tmHeight. Des marques d’accentuation et d’autres caractères diacritiques peuvent se produire dans cette zone. Le concepteur peut définir ce membre sur zéro.
tmExternalLeading
Quantité de début supplémentaire (espace) que l’application ajoute entre les lignes. Étant donné que cette zone est en dehors de la police, elle ne contient aucune marque et n’est pas modifiée par les appels de sortie de texte en mode OPAQUE ou TRANSPARENT. Le concepteur peut définir ce membre sur zéro.
tmAveCharWidth
Largeur moyenne des caractères dans la police (généralement définie comme largeur de la lettre x). Cette valeur n’inclut pas le surplomb requis pour les caractères gras ou italiques.
tmMaxCharWidth
Largeur du caractère le plus large dans la police.
tmWeight
Poids de la police.
tmOverhang
Largeur supplémentaire par chaîne qui peut être ajoutée à certaines polices synthétisées. Lors de la synthèse de certains attributs, tels que gras ou italique, l’interface d’appareil graphique (GDI) ou un appareil peut devoir ajouter de la largeur à une chaîne à la fois par caractère et par chaîne. Par exemple, GDI met en gras une chaîne en développant l’espacement de chaque caractère et en surtentant par une valeur de décalage ; italique une police en cliquant sur la chaîne. Dans les deux cas, il existe un surplomb au-delà de la chaîne de base. Pour les chaînes en gras, le surplomb est la distance par laquelle le surstrike est décalé. Pour les chaînes italiques, le surplomb est la quantité située en haut de la police au-delà du bas de la police.
Le membre
tmDigitizedAspectX
Aspect horizontal de l’appareil pour lequel la police a été conçue.
tmDigitizedAspectY
Aspect vertical de l’appareil pour lequel la police a été conçue. Le ratio des membres tmDigitizedAspectX et tmDigitizedAspectY membres est le rapport aspect de l’appareil pour lequel la police a été conçue.
tmFirstChar
Valeur du premier caractère défini dans la police.
tmLastChar
Valeur du dernier caractère défini dans la police.
tmDefaultChar
Valeur du caractère à remplacer par les caractères qui ne sont pas dans la police.
tmBreakChar
Valeur du caractère qui sera utilisé pour définir des sauts de mots pour la justification de texte.
tmItalic
Spécifie une police italique si elle n’est pas nulle.
tmUnderlined
Spécifie une police soulignée si elle n’est pas nulle.
tmStruckOut
Police de grève si elle n’est pas nulle.
tmPitchAndFamily
Spécifie des informations sur la hauteur, la technologie et la famille d’une police physique.
Les quatre bits de bas ordre de ce membre spécifient des informations sur la hauteur et la technologie de la police. Une constante est définie pour chacun des quatre bits.
| Constant | Signification |
|---|---|
| TMPF_FIXED_PITCH | Si ce bit est défini, la police est une police de tangage variable. Si ce bit est clair, la police est une police de tangage fixe. Notez très attentivement que ces significations sont l’opposé de ce que le nom constant implique. |
| TMPF_VECTOR | Si ce bit est défini, la police est une police vectorielle. |
| TMPF_TRUETYPE | Si ce bit est défini, la police est une police TrueType. |
| TMPF_DEVICE | Si ce bit est défini, la police est une police d’appareil. |
Une application doit tester soigneusement les qualités encodées dans ces bits de bas ordre, sans hypothèses arbitraires. Par exemple, en plus d’avoir leur propre jeu de bits, les polices TrueType et PostScript définissent le bit TMPF_VECTOR. Une police bitmap monospace a tous ces bits de faible ordre clair ; une police bitmap proportionnelle définit le bit TMPF_FIXED_PITCH. Une police d’imprimante Postscript définit les bits TMPF_DEVICE, TMPF_VECTOR et TMPF_FIXED_PITCH.
Les quatre bits de tmPitchAndFamily désigner la famille de polices de la police. Une application peut utiliser la valeur 0xF0 et l’opérateur AND au niveau du bit pour masquer les quatre bits de faible ordre de tmPitchAndFamily, obtenant ainsi une valeur qui peut être directement comparée aux noms de famille de polices pour trouver une correspondance identique. Pour plus d’informations sur les familles de polices, consultez la description de la structure LOGFONT
tmCharSet
Jeu de caractères de la police. Le jeu de caractères peut être l’une des valeurs suivantes.
- 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
Remarques
Note
L’en-tête wingdi.h définit TEXTMETRIC comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| d’en-tête | wingdi.h (include Windows.h) |
Voir aussi
structures de police et de texte