Fonction SetTextAlign (wingdi.h)

Article
08/27/2023

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))


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