Partager via


GetTextAlign, fonction (wingdi.h)

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 :

  1. Appliquez l’opérateur OR au niveau du bit à l’indicateur et à ses indicateurs associés.
  2. Appliquez l’opérateur AND au niveau du bit au résultat et à la valeur de retour.
  3. 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

Voir aussi

ExtTextOut

Fonctions de police et de texte

Vue d’ensemble des polices et du texte

GetTextExtentPoint32

SetTextAlign

Textout