Valeurs de format

Cette section répertorie les valeurs qui sont 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 en _ bas Génère le rendu de la chaîne de texte en bas du rectangle d’affichage. Cette valeur est utilisée uniquement avec la valeur de la _ valeur DT Singleline.
_CALCRECT DT Détermine la largeur et la hauteur du rectangle d’affichage.
_Centre DT Centre le texte horizontalement dans le rectangle d’affichage.
_EDITCONTROL DT Duplique les caractéristiques d’affichage de texte d’un contrôle d’édition multiligne. Plus précisément, la largeur de caractère moyenne est calculée de la même manière que pour un contrôle d’édition, et la fonction n’affiche pas une dernière ligne partiellement visible.
points de suspension de _ fin DT _ Tronque une chaîne de texte plus grande que le rectangle d’affichage et ajoute des points de suspension pour indiquer la troncation. La chaîne n’est pas modifiée à moins que l' _ indicateur DT MODIFYSTRING soit spécifié.
_ExpandTabs DT Développe des caractères de tabulation. Le nombre par défaut de caractères par tabulation est huit. Vous ne pouvez pas utiliser les points de suspension de mot de passe DT _ _ , les points de suspension du _ chemin DT _ et _ les points de suspension de fin DT _ avec la _ valeur DT ExpandTabs.
_EXTERNALLEADING DT Comprend le caractère externe de début 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.
_HIDEPREFIX DT Ignore le caractère de préfixe & dans le texte. La lettre qui suit n’est pas soulignée, mais les autres caractères de préfixe sont toujours traités. Par exemple :
chaîne d’entrée : « A&BC&&d »
normal : « Abc&d »
DT _ HIDEPREFIX : « Abc&d »
DT à _ gauche Aligne le texte à gauche.
_MODIFYSTRING DT Modifie une chaîne pour qu’elle corresponde au texte affiché. Cette valeur n’a aucun effet à moins que les points de suspension des _ _ points de suspension DT ou DT _ _ soient spécifiés.
DT _ NOclip Dessine la chaîne de texte sans découper le rectangle d’affichage.
_NOFULLWIDTHCHARBREAK DT Empêche un saut de ligne à un jeu de caractères codés sur deux octets (DBCS), afin que la règle de saut de ligne soit équivalente à un jeu de caractères codés sur un octet (SBCS). Cela peut être utilisé, par exemple, pour rendre les étiquettes d’icône écrites en texte coréen plus lisibles. Cette valeur n’a aucun effet, sauf si DT _ WordBreak est spécifié.
_préfixe DT 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 && en tant que directive pour imprimer une seule &. En spécifiant DT _ NoPrefix, ce traitement est désactivé. Par exemple :
chaîne d’entrée : « A&BC&&d »
normal : « Abc&d »
DT _ NoPrefix : « A&bc&&d »
points de suspension du _ chemin DT _ Remplace les caractères au milieu du texte par des points de suspension afin que le résultat tienne dans le rectangle d’affichage. Si la chaîne contient des caractères de barre oblique inverse ( \ ), les _ _ points de suspension du chemin d’accès DT préservent le plus possible du texte après la dernière barre oblique inverse. La chaîne n’est pas modifiée à moins que l' _ indicateur DT MODIFYSTRING soit spécifié.
_PREFIXONLY DT 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 && en tant que directive pour imprimer une seule &. En spécifiant DT _ PREFIXONLY, aucun caractère n’est dessiné, mais uniquement un trait de soulignement. Les espaces blancs sont placés aux positions où les caractères s’affichent normalement. Par exemple :
chaîne d’entrée : « A&BC&&d »
normal : «Abc&d
DT _ PREFIXONLY : " "
DT- _ droit Aligne le texte à droite.
_RTLREADING DT Aligne le texte dans l’ordre de droite à gauche pour du texte bidirectionnel, par exemple, du texte dans une police hébraïque ou arabe. La direction par défaut du texte est de gauche à droite.
DT _ Singleline Affiche du texte sur une seule ligne. Les retours chariot et les sauts de ligne n’interrompent pas la ligne.
DT _ TABSTOP Définit des taquets de tabulation.
DT en _ haut Génère le rendu du texte en haut du rectangle d’affichage.
_VCENTER DT Centre le texte verticalement. Cette valeur est utilisée uniquement avec la valeur de la _ valeur DT Singleline.
_WordBreak DT Scinde les lignes entre les mots si un mot s’étend au-delà du bord du rectangle d’affichage. Une séquence de retour chariot/saut de ligne (CR/LF) interrompt également la ligne.
points de suspension de _ mot DT _ Tronque tout mot qui ne tient pas dans le rectangle d’affichage et ajoute des points de suspension.