Partager via


Fonction SetTextAlign (wingdi.h)

La fonction SetTextAlign définit les indicateurs d’alignement du texte pour le contexte d’appareil spécifié.

Syntaxe

UINT SetTextAlign(
  [in] HDC  hdc,
  [in] UINT align
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

[in] align

Alignement du texte à l’aide d’un masque des valeurs de la liste suivante. Un seul indicateur peut être choisi parmi ceux qui affectent l’alignement horizontal et vertical. En outre, un seul des deux indicateurs qui modifient la position actuelle peut être choisi.

Valeur Signification
TA_BASELINE
Le point de référence se trouvera sur la ligne de base du texte.
TA_BOTTOM
Le point de référence se trouve sur le bord inférieur du rectangle englobant.
TA_TOP
Le point de référence se trouve sur le bord supérieur du rectangle englobant.
TA_CENTER
Le point de référence est aligné horizontalement sur le centre du rectangle englobant.
TA_LEFT
Le point de référence se trouvera sur le bord gauche du rectangle englobant.
TA_RIGHT
Le point de référence se trouvera sur le bord droit du rectangle englobant.
TA_NOUPDATECP
La position actuelle n’est pas mise à jour après chaque appel de sortie de texte. Le point de référence est passé à la fonction de sortie de texte.
TA_RTLREADING
Édition en langue du Moyen-Orient de Windows : Le texte est disposé dans l’ordre de lecture de droite à gauche, par opposition à l’ordre par défaut de gauche à droite. Cela s’applique uniquement lorsque la police sélectionnée dans le contexte de l’appareil est hébraïque ou arabe.
TA_UPDATECP
La position actuelle est mise à jour après chaque appel de sortie de texte. La position actuelle est utilisée comme point de référence.
 

Lorsque la police actuelle a une ligne de base verticale par défaut, comme avec Kanji, les valeurs suivantes doivent être utilisées au lieu de TA_BASELINE et TA_CENTER.

Valeur Signification
VTA_BASELINE
Le point de référence se trouvera sur la ligne de base du texte.
VTA_CENTER
Le point de référence est aligné verticalement avec le centre du rectangle englobant.
 

Les valeurs par défaut sont TA_LEFT, TA_TOP et TA_NOUPDATECP.

Valeur retournée

Si la fonction réussit, la valeur de retour est le paramètre d’alignement du texte précédent.

Si la fonction échoue, la valeur de retour est GDI_ERROR.

Remarques

Les fonctions TextOut et ExtTextOut utilisent les indicateurs d’alignement du texte pour positionner une chaîne de texte sur un écran ou un autre appareil. Les indicateurs spécifient la relation entre un point de référence et un rectangle qui limite le texte. Le point de référence est la position actuelle ou un point passé à une fonction de sortie de texte.

Le rectangle qui limite le texte est formé par les cellules de caractères dans la chaîne de texte.

La meilleure façon d’obtenir un texte aligné à gauche est d’utiliser l’un ou l’autre


SetTextAlign (hdc, GetTextAlign(hdc) & (~TA_CENTER))

ou


SetTextAlign (hdc,TA_LEFT | <other flags>)

Vous pouvez également utiliser SetTextAlign (hdc, TA_LEFT) à cet effet, mais cela perd tous les paramètres verticaux ou de droite à gauche.

Note Vous ne devez pas utiliser SetTextAlign avec TA_UPDATECP lorsque vous utilisez ScriptStringOut, car le texte sélectionné n’est pas rendu correctement. Si vous devez utiliser cet indicateur, vous pouvez l’annuler et le réinitialiser si nécessaire pour éviter le problème.
 

Exemples

Pour obtenir un exemple, consultez Définition de l’alignement du texte.

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]
Plateforme cible Windows
En-tête wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

ExtTextOut

Fonctions police et texte

Vue d’ensemble des polices et du texte

GetTextAlign

ScriptStringOut

Textout