Valeurs de format

Cette section répertorie les valeurs utilisées avec le paramètre dwTextFlags des fonctions DrawThemeText et GetThemeTextExtent . Une ou plusieurs de ces valeurs sont utilisées pour spécifier la façon dont une chaîne de texte doit être mise en forme. La fonction DrawThemeText dessine la chaîne de texte à l’intérieur d’un rectangle d’affichage, spécifié par le paramètre pRect . La fonction GetThemeTextExtent peut être utilisée pour déterminer le rectangle englobant nécessaire pour le texte d’une longueur et d’un format donnés.

Valeurs de format

Le tableau suivant répertorie les valeurs de format.

Valeur	Description
DT_BOTTOM	Restitue la chaîne de texte en bas du rectangle d’affichage. Cette valeur est utilisée uniquement avec la valeur DT_SINGLELINE.
DT_CALCRECT	Détermine la largeur et la hauteur du rectangle d’affichage.
DT_CENTER	Centre le texte horizontalement dans le rectangle d’affichage.
DT_EDITCONTROL	Duplique les caractéristiques d’affichage de texte d’un contrôle d’édition multiligne. Plus précisément, la largeur moyenne des caractères est calculée de la même manière que pour un contrôle d’édition, et la fonction n’affiche pas de dernière ligne partiellement visible.
DT_END_ELLIPSIS	Tronque une chaîne de texte plus large que le rectangle d’affichage et ajoute des points de suspension pour indiquer la troncation. La chaîne n’est pas modifiée, sauf si l’indicateur DT_MODIFYSTRING est spécifié.
DT_EXPANDTABS	Développe des caractères de tabulation. Le nombre par défaut de caractères par tabulation est huit. Les valeurs DT_WORD_ELLIPSIS, DT_PATH_ELLIPSIS et DT_END_ELLIPSIS ne peuvent pas être utilisées avec la valeur DT_EXPANDTABS.
DT_EXTERNALLEADING	Inclut le début externe d’une police dans la hauteur de ligne. Normalement, le début externe n’est pas inclus dans la hauteur d’une ligne de texte.
DT_HIDEPREFIX	Ignore le caractère & de préfixe dans le texte. La lettre qui suit n’est pas soulignée, mais d’autres caractères de préfixe sont toujours traités. Exemple : chaîne d’entrée : « A&bc&&d » normal: « Abc&d » DT_HIDEPREFIX: « Abc&d »
DT_LEFT	Aligne le texte à gauche.
DT_MODIFYSTRING	Modifie une chaîne pour qu’elle corresponde au texte affiché. Cette valeur n’a aucun effet, sauf si DT_END_ELLIPSIS ou DT_PATH_ELLIPSIS est spécifié.
DT_NOCLIP	Dessine la chaîne de texte sans couper le rectangle d’affichage.
DT_NOFULLWIDTHCHARBREAK	Empêche un saut de ligne au niveau d’un jeu de caractères codés sur deux octets (DBCS), de sorte que la règle de saut de ligne équivaut à un jeu de caractères codés sur un octet (SBCS). Cela peut être utilisé, par exemple, pour rendre les étiquettes d’icônes écrites en texte coréen plus lisibles. Cette valeur n’a aucun effet, sauf si DT_WORDBREAK est spécifié.
DT_NOPREFIX	Désactive le traitement des caractères de préfixe. Normalement, DrawThemeText interprète le caractère & de préfixe comme une directive pour souligner le caractère qui suit, et les caractères && de préfixe comme une directive pour imprimer un seul &. En spécifiant DT_NOPREFIX, ce traitement est désactivé. Exemple : chaîne d’entrée : « A&bc&&d » normal: « Abc&d » DT_NOPREFIX: « A&bc&&d »
DT_PATH_ELLIPSIS	Remplace les caractères au milieu du texte par des points de suspension afin que le résultat s’inscrive dans le rectangle d’affichage. Si la chaîne contient des caractères barre oblique inverse (\), DT_PATH_ELLIPSIS conserve autant que possible le texte après la dernière barre oblique inverse. La chaîne n’est pas modifiée, sauf si l’indicateur DT_MODIFYSTRING est spécifié.
DT_PREFIXONLY	Dessine uniquement un trait de soulignement à la position du caractère suivant le caractère &de préfixe . Normalement , DrawThemeText interprète le & comme une directive pour souligner le caractère qui suit et les caractères && de préfixe comme une directive pour imprimer un seul &. En spécifiant DT_PREFIXONLY, aucun caractère n’est dessiné, seulement un trait de soulignement. Les espaces blancs sont placés dans les emplacements où les caractères apparaissent normalement. Exemple : chaîne d’entrée : « A&bc&&d » normal: « Abc&d DT_PREFIXONLY: " »
DT_RIGHT	Aligne le texte à droite.
DT_RTLREADING	Dispose le texte dans l’ordre de droite à gauche pour le texte bidirectionnel, par exemple le texte dans une police hébraïque ou arabe. La direction par défaut du texte est de gauche à droite.
DT_SINGLELINE	Affiche le texte sur une seule ligne. Les retours chariots et les sauts de ligne n’interrompent pas la ligne.
DT_TABSTOP	Définit les taquets de tabulation.
DT_TOP	Restitue le texte en haut du rectangle d’affichage.
DT_VCENTER	Centre le texte verticalement. Cette valeur est utilisée uniquement avec la valeur DT_SINGLELINE.
DT_WORDBREAK	Divise les lignes entre les mots si un mot dépasse le bord du rectangle d’affichage. Une séquence retour chariot/saut de ligne (CR/LF) interrompt également la ligne.
DT_WORD_ELLIPSIS	Tronque tout mot qui ne tient pas dans le rectangle d’affichage et ajoute des points de suspension.