NEWTEXTMETRICW, structure (wingdi.h)
La structure NEWTEXTMETRIC contient des données qui décrivent une police physique.
Syntaxe
typedef struct tagNEWTEXTMETRICW {
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;
DWORD ntmFlags;
UINT ntmSizeEM;
UINT ntmCellHeight;
UINT ntmAvgWidth;
} NEWTEXTMETRICW, *PNEWTEXTMETRICW, *NPNEWTEXTMETRICW, *LPNEWTEXTMETRICW;
Membres
tmHeight
Hauteur (montée + descente) des caractères.
tmAscent
L’ascension (unités au-dessus de la ligne de base) des caractères.
tmDescent
Descente (unités sous 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 apparaître dans cette zone. Le concepteur peut définir ce membre sur zéro.
tmExternalLeading
Quantité de début (espace) supplémentaire que l’application ajoute entre les lignes. Étant donné que cette zone se trouve 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
La largeur du caractère le plus large de 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 de périphérique graphique (GDI) ou un appareil peut être amené à ajouter de la largeur à une chaîne à la fois par caractère et par chaîne. Par exemple, GDI met une chaîne en gras en développant l’espacement de chaque caractère et en remplaçant par une valeur de décalage ; italicise une police en cliquant la chaîne. Dans les deux cas, il y a 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é que le haut de la police est ciselé au-delà du bas de la police.
Le membre tmOverhang permet à l’application de déterminer la largeur de caractères retournée par un appel de fonction GetTextExtentPoint32 sur un caractère unique est la largeur réelle des caractères et la largeur supplémentaire par chaîne. La largeur réelle est l’étendue moins le surplomb.
tmDigitizedAspectX
Aspect horizontal du périphérique pour lequel la police a été conçue.
tmDigitizedAspectY
Aspect vertical du périphérique pour lequel la police a été conçue. Le ratio des membres tmDigitizedAspectX et tmDigitizedAspectY est le rapport des proportions 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 figurent pas dans la police.
tmBreakChar
Valeur du caractère à utiliser pour définir des sauts de mots pour la justification du texte.
tmItalic
Police italique si elle est différente de zéro.
tmUnderlined
Police soulignée si elle est différente de zéro.
tmStruckOut
Police barré si elle n’est pas nulle.
tmPitchAndFamily
Hauteur et famille de la police sélectionnée. Le bit d’ordre inférieur (bit 0) spécifie la hauteur de la police. S’il est égal à 1, la police est de hauteur variable (ou proportionnelle). S’il est égal à 0, la police est une hauteur fixe (ou monospace). Les bits 1 et 2 spécifient le type de police. Si les deux bits ont la valeur 0, la police est une police raster ; si bit 1 est 1 et bit 2 est 0, la police est une police vectorielle ; si bit 1 est 0 et bit 2 est défini, ou si les deux bits ont la valeur 1, la police est un autre type. Bit 3 est 1 si la police est une police d’appareil ; sinon, c’est 0.
Les quatre bits d’ordre supérieur désignent la famille de polices. Le membre tmPitchAndFamily peut être combiné avec la valeur hexadécimale 0xF0 à l’aide de l’opérateur AND au niveau du bit et peut ensuite être comparé avec les noms de famille de polices pour obtenir une correspondance identique. Pour plus d’informations sur les familles de polices, consultez LOGFONT.
tmCharSet
Jeu de caractères de la police.
ntmFlags
Spécifie si la police est italique, soulignée, soulignée, en gras, etc. Il peut s’agir d’une combinaison raisonnable des valeurs suivantes.
| bit | Nom | Signification |
|---|---|---|
| 0 | NTM_ITALIC | italique |
| 5 | NTM_BOLD | gras |
| 8 | NTM_REGULAR | regular |
| 16 | NTM_NONNEGATIVE_AC | Aucun glyphe dans une police, quelle que soit la taille, n’a un espace A ou C négatif. |
| 17 | NTM_PS_OPENTYPE | Police OpenType PostScript |
| 18 | NTM_TT_OPENTYPE | Police OpenType TrueType |
| 19 | NTM_MULTIPLEMASTER | police master multiples |
| 20 | NTM_TYPE1 | Police de type 1 |
| 21 | NTM_DSIG | police avec une signature numérique. Cela permet la traçabilité et garantit que la police a été testée et n’est pas endommagée |
ntmSizeEM
Taille du carré em pour la police. Cette valeur est en unités théoriques (c’est-à-dire les unités pour lesquelles la police a été conçue).
ntmCellHeight
Hauteur, en unités théoriques, de la police. Cette valeur doit être comparée à la valeur du membre ntmSizeEM .
ntmAvgWidth
Largeur moyenne des caractères dans la police, en unités théoriques. Cette valeur doit être comparée à la valeur du membre ntmSizeEM .
Remarques
Les quatre derniers membres de la structure NEWTEXTMETRIC ne sont pas inclus dans la structure TEXTMETRIC ; à tous les autres égards, les structures sont identiques.
Les tailles de la structure NEWTEXTMETRIC sont généralement spécifiées en unités logiques ; Autrement dit, elles dépendent du mode de mappage actuel du contexte d’affichage.
Notes
L’en-tête wingdi.h définit NEWTEXTMETRIC comme un 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. La combinaison 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.
Configuration requise
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| En-tête | wingdi.h (inclure Windows.h) |
Voir aussi
Structures de police et de texte
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour