Mettre en forme les valeurs
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ée 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.
Mettre en forme les valeurs
Le tableau suivant répertorie les valeurs de format.
| Valeur | Description |
|---|---|
| DT_BOTTOM | Affiche 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 | Dupliquer 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 une dernière ligne partiellement visible. |
| DT_END_ELLIPSIS | Tronque une chaîne de texte plus large que le rectangle d’affichage et ajoute un point 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 les caractères d’onglet. Le nombre par défaut de caractères par onglet est de 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. Par 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 découper le rectangle d’affichage. |
| DT_NOFULLWIDTHCHARBREAK | Empêche un saut de ligne à un jeu de caractères double octet (DBCS), de sorte que la règle de rupture de ligne équivaut à un jeu de caractères sur un octet (SBCS). Cela peut être utilisé, par exemple, pour rendre les étiquettes d’icônes écrites dans du texte coréen plus lisible. 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 directive pour imprimer un seul &. 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 » |
| DT_PATH_ELLIPSIS | Remplace les caractères au milieu du texte par des points de suspension afin que le résultat s’intègre dans le rectangle d’affichage. Si la chaîne contient des caractères inverses (\), 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 && en tant que directive pour imprimer une seule &. En spécifiant DT_PREFIXONLY, aucun caractère n’est dessiné, un trait de soulignement uniquement. Les espaces blancs sont placés dans les positions où les caractères apparaissent normalement. Par exemple: chaîne d’entrée : « A&bc&&d » normal : « Abc&d DT_PREFIXONLY : " » |
| DT_RIGHT | Aligne le texte à droite. |
| DT_RTLREADING | Place le texte dans l’ordre de droite à gauche pour le 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 chariots et les sauts de ligne ne rompent pas la ligne. |
| DT_TABSTOP | Définit les taquets de tabulation. |
| DT_TOP | Affiche 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 | Interrompt les lignes entre les mots si un mot s’étend au-delà du 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 un point de suspension. |