GetTextAlign, fonction (wingdi.h)

Article
08/27/2023

La fonction GetTextAlign récupère le paramètre d’alignement du texte pour le contexte d’appareil spécifié.

Syntaxe

UINT GetTextAlign(
  [in] HDC hdc
);

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

Valeur retournée

Si la fonction réussit, la valeur de retour est la status des indicateurs d’alignement du texte. Pour plus d’informations sur la valeur de retour, consultez la section Remarques. La valeur de retour est une combinaison des valeurs suivantes.

Valeur	Signification
TA_BASELINE	Le point de référence se trouve 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 avec le centre du rectangle englobant.
TA_LEFT	Le point de référence se trouve sur le bord gauche du rectangle englobant.
TA_RIGHT	Le point de référence se trouve sur le bord droit du rectangle englobant.
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 l’hébreu ou l’arabe.
TA_NOUPDATECP	La position actuelle n’est pas mise à jour après chaque appel de sortie de texte.
TA_UPDATECP	La position actuelle est mise à jour après chaque appel de sortie de texte.

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

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

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

Remarques

Le rectangle englobant est un rectangle englobant toutes les cellules de caractères d’une chaîne de texte. Ses dimensions peuvent être obtenues en appelant la fonction GetTextExtentPoint32 .

Les indicateurs d’alignement du texte déterminent comment les fonctions TextOut et ExtTextOut alignent une chaîne de texte par rapport au point de référence de la chaîne fourni à TextOut ou ExtTextOut.

Les indicateurs d’alignement du texte ne sont pas nécessairement des indicateurs de bits uniques et peuvent être égaux à zéro. Les indicateurs doivent être examinés dans des groupes d’indicateurs connexes, comme indiqué dans la liste suivante.

TA_LEFT, TA_RIGHT et TA_CENTER
TA_BOTTOM, TA_TOP et TA_BASELINE
TA_NOUPDATECP et TA_UPDATECP

Si la police actuelle a une ligne de base verticale par défaut, les indicateurs associés sont indiqués dans la liste suivante.

TA_LEFT, TA_RIGHT et VTA_BASELINE
TA_BOTTOM, TA_TOP et VTA_CENTER
TA_NOUPDATECP et TA_UPDATECP

Pour vérifier qu’un indicateur particulier est défini dans la valeur de retour de cette fonction :

Appliquez l’opérateur OR au niveau du bit à l’indicateur et à ses indicateurs associés.
Appliquez l’opérateur AND au niveau du bit au résultat et à la valeur de retour.
Testez l’égalité de ce résultat et de l’indicateur.

Exemples

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

Configuration requise

Condition requise	Valeur
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