attributs Text-Formatting
Une application peut utiliser six fonctions pour définir les attributs de mise en forme de texte pour un contexte d’appareil : SetBkColor, SetBkMode, SetTextAlign, SetTextCharacterExtra, SetTextColor et SetTextJustification. Ces fonctions affectent l’alignement du texte, l’espacement entre les caractères, la justification du texte et les couleurs de texte et d’arrière-plan. En outre, six autres fonctions peuvent être utilisées pour récupérer les attributs de mise en forme de texte actuels pour n’importe quel contexte d’appareil : GetBkColor, GetBkMode, GetTextAlign, GetTextCharacterExtra, GetTextColor et GetTextExtentPoint32.
Alignement du texte
Les applications peuvent utiliser la fonction SetTextAlign pour spécifier la façon dont le système doit positionner les caractères dans une chaîne de texte lorsqu’ils appellent l’une des fonctions de dessin. Cette fonction peut être utilisée pour positionner les en-têtes, les numéros de page, les légendes, etc. Le système positionne une chaîne de texte en alignant un point de référence sur un rectangle imaginaire qui entoure la chaîne, avec la position actuelle du curseur ou avec un point passé en tant qu’argument à l’une des fonctions de dessin de texte. La fonction SetTextAlign permet à l’application de spécifier l’emplacement de ce point de référence. Voici une liste des emplacements de points de référence possibles.
| Emplacement | Description |
|---|---|
| gauche/bas | Le point de référence se trouve dans le coin inférieur gauche du rectangle. |
| gauche/ligne de base | Le point de référence se trouve à l’intersection de la ligne de base de cellule de caractère et du bord gauche du rectangle. |
| gauche/haut | Le point de référence se trouve dans le coin supérieur gauche du rectangle. |
| centre/bas | Le point de référence se trouve au centre du bas du rectangle. |
| ligne de base/centre | Le point de référence se trouve à l’intersection de la ligne de base de cellule de caractère et du centre du rectangle. |
| centre/haut | Le point de référence se trouve au centre du haut du rectangle. |
| droite/bas | Le point de référence se trouve dans l’angle inférieur droit du rectangle. |
| droite/ligne de base | Le point de référence se trouve à l’intersection de la ligne de base de cellule de caractères et du bord droit du rectangle. |
| droite/haut | Le point de référence se trouve dans le coin supérieur droit du rectangle. |
L’illustration suivante montre une chaîne de texte dessinée en appelant la fonction TextOut . Avant de dessiner le texte, la fonction SetTextAlign a été appelée pour déplacer le point de référence à chacun des neuf emplacements possibles.
L’alignement du texte par défaut pour un contexte d’appareil est le coin supérieur gauche du rectangle imaginaire qui entoure le texte. Une application peut récupérer le paramètre d’alignement du texte actuel pour n’importe quel contexte d’appareil en appelant la fonction GetTextAlign .
Intercharacter Espacement
Les applications peuvent utiliser la fonction SetTextCharacterExtra pour modifier l’interligne pour toutes les opérations de sortie de texte dans un contexte d’appareil spécifié. L’illustration suivante montre une chaîne de texte dessinée deux fois en appelant la fonction TextOut . Avant de dessiner le texte la deuxième fois, la fonction SetTextCharacterExtra a été appelée pour incrémenter l’espacement entre les caractères.
La valeur d’espacement intercaracteur par défaut pour n’importe quel contexte d’appareil est zéro. Une application peut récupérer la valeur d’espacement intercaracteur actuelle pour un contexte d’appareil en appelant la fonction GetTextCharacterExtra .
Justification textuelle
Les applications peuvent utiliser les fonctions GetTextExtentPoint32 et SetTextJustification pour justifier une ligne de texte. La justification du texte est une opération courante dans toute publication de bureau et dans la plupart des applications de traitement de texte. La fonction GetTextExtentPoint32 calcule la largeur et la hauteur d’une chaîne de texte. Une fois la largeur calculée, l’application peut appeler la fonction SetTextJustification pour distribuer un espacement supplémentaire entre chacun des mots d’une ligne de texte. L’illustration suivante montre un paragraphe de texte imprimé deux fois : dans le premier paragraphe, le texte n’était pas justifié; dans le deuxième paragraphe, le texte était justifié en appelant les fonctions GetTextExtentPoint32 et SetTextJustification .
Texte et couleur d’arrière-plan
Les applications peuvent utiliser la fonction SetTextColor pour définir la couleur du texte dessiné dans la zone cliente de leurs fenêtres, ainsi que la couleur du texte dessiné sur une imprimante couleur. Une application peut utiliser la fonction SetBkColor pour définir la couleur qui s’affiche derrière chaque caractère et la fonction SetBkMode pour spécifier comment le système doit fusionner la couleur d’arrière-plan sélectionnée avec la ou les couleurs actuelles sur l’affichage vidéo.
La couleur de texte par défaut d’un contexte de périphérique d’affichage est le noir ; la couleur d’arrière-plan par défaut est le blanc ; et le mode d’arrière-plan par défaut est OPAQUE. Une application peut récupérer la couleur de texte actuelle d’un contexte d’appareil en appelant la fonction GetTextColor . Une application peut récupérer la couleur d’arrière-plan actuelle d’un contexte d’appareil en appelant la fonction GetBkColor et le mode d’arrière-plan actuel en appelant la fonction GetBkMode .