CDC::DrawText
Appelez la fonction membre pour mettre en forme le texte dans le rectangle donné.Pour spécifier des options de mise en forme supplémentaires, utilisez CDC::DrawTextEx.
virtual int DrawText(
LPCTSTR lpszString,
int nCount,
LPRECT lpRect,
UINT nFormat
);
int DrawText(
const CString& str,
LPRECT lpRect,
UINT nFormat
);
Paramètres
lpszString
Pointe vers une chaîne à dessiner.Si nCount est à 1, la chaîne doit être se terminant par null.nCount
Spécifie le nombre de caractères dans la chaîne.Si nCount est – il est supposé que 1, alors lpszString sont un long pointeur vers une chaîne terminée par le caractère NULL et DrawText calcule le nombre de caractères automatiquement.lpRect
Les points à RECT structure ou d'objets de CRect qui contient le rectangle (dans les coordonnées logiques) dans laquelle le texte doit être mis en forme.str
Un objet de CString qui contient les caractères spécifiés à dessiner.nFormat
Spécifie la méthode de mise en forme du texte.Ce peut être toute combinaison des valeurs décrites pour le paramètre d' uFormat dans DrawText dans Kit de développement logiciel Windows.(combiner à l'aide de l'opérateur de bits OR) :[!REMARQUE]
Certaines combinaisons de balise d' uFormat peuvent provoquer la chaîne passée d'être modifiées.Utilisation DT_MODIFYSTRING avec DT_END_ELLIPSIS ou DT_PATH_ELLIPSIS peut entraîner la chaîne d'être modifié, provoquant une assertion dans la substitution d' CString .Les valeurs DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP, et DT_NOPREFIX ne peuvent pas être utilisées avec la valeur d' DT_TABSTOP .
Valeur de retour
La hauteur du texte si la fonction est réussie.
Notes
Elle met en forme le texte en développant des tabulations en espaces appropriés, alignant le texte sélectionné vers la gauche, droite, ou centre du rectangle donné, et pour arrêter le texte dans des lignes qui correspondent dans le rectangle donné.Le type de mise en forme est spécifié par nFormat.
Cette fonction membre utilise la police du contexte de périphérique, la couleur de texte, et la couleur d'arrière-plan sélectionnées pour dessiner le texte.À moins que le format d' DT_NOCLIP soit utilisé, DrawText couper le texte afin que le texte ne paraisse pas l'extérieur de le rectangle donné.Il est supposé que la mise en forme plusieurs lignes à moins que le format d' DT_SINGLELINE soit donné.
Si la police sélectionnée est trop grande pour le rectangle spécifié, la fonction membre d' DrawText ne tente pas de substituer une plus petite police.
Si la balise d' DT_CALCRECT est spécifiée, le rectangle spécifié par lpRect est mis à jour pour refléter la largeur et la hauteur nécessaire pour dessiner le texte.
Si la balise d'alignement de texte de TA_UPDATECP a été définie (consultez CDC::SetTextAlign), DrawText veulent le texte à partir de la position actuelle, plutôt qu'à la gauche du rectangle donné.DrawText n'encapsulera pas le texte lorsque la balise de TA_UPDATECP a été définie (autrement dit, la balise d' DT_WORDBREAK n'aura aucun effet.)
La couleur de texte peut être définie par CDC::SetTextColor.
Configuration requise
Header: afxwin.h