Partager via


CDC::TextOut

Écrit une chaîne de caractères à l'emplacement spécifié à l'aide de la police sélectionnée.

virtual BOOL TextOut( 
   int x, 
   int y, 
   LPCTSTR lpszString, 
   int nCount  
); 
BOOL TextOut( 
   int x,
   int y,
   const CString& str 
);

Paramètres

  • x
    Spécifie la coordonnée x logique du point de départ du texte.

  • y
    Spécifie la coordonnée y logique du point de départ du texte.

  • lpszString
    Pointe vers la chaîne de caractères à ajouter.

  • nCount
    Spécifie le nombre de caractères de la chaîne.

  • str
    Objet CString qui contient les caractères à ajouter.

Valeur de retour

Une valeur différente de zéro si la fonction réussit ; sinon, 0.

Notes

L'origine des caractères se trouve dans l'angle supérieur gauche de la cellule de caractère. Par défaut, la position actuelle n'est pas utilisée ni mise à jour par la fonction.

Si une application doit mettre à jour la position actuelle lorsqu'elle appelle TextOut, l'application peut appeler la fonction membre SetTextAlign avec nFlags défini sur TA_UPDATECP. Lorsque cet indicateur est activé, Windows ignore les paramètres x et y lors des appels suivants à TextOut, en utilisant la position actuelle.

Exemple

Voir un exemple pour CDC::BeginPath.

Configuration requise

En-tête : afxwin.h

Voir aussi

Référence

CDC, classe

Graphique de la hiérarchie

CDC::ExtTextOut

CDC::GetTextExtent

CDC::SetTextAlign

CDC::SetTextColor

CDC::TabbedTextOut

TextOut