CDC::DrawText

virtuel int DrawText ( LPCTSTR lpszString, int nCount, LPRECT lpRect, UINT nFormat );

int Dr&awText (const CStringamp ;strLPRECTlpRectUINTnFormat );

Valeur de retour

La hauteur du texte si la fonction a réussi.

Paramètres

lpszString

Points de la chaîne à tirer. Si nCount est – 1, la chaîne doit être terminée par null.

nCount

Spécifie le nombre de caractères dans la chaîne. Si nCount est – 1, alors lpszString est supposé pour être qu'un long pointeur vers une chaîne terminée par null et DrawText calcule le nombre de caractères automatiquement.

lpRect

Pointe vers une structure RECT ou objet CRect qui contient le rectangle (en coordonnées logiques) dans lequel le texte doit être formatée.

str

;Un objet CString qui contient les caractères spécifiés à tirer.

nFormat

Spécifie la méthode de mise en forme du texte. Il peut être n'importe quelle combinaison des valeurs suivantes (combiner à l'aide de l'opérateur de bits OR):

DT_BOTTOMnbsp ; Spécifie le texte justifié à fond. Cette valeur doit être combinée avec DT_SI&NGLELINE.
DT_CALCRECT ; Détermine la largeur et la hauteur du rectangle. S'il y a plusieurs lignes de texte, DrawText utilisera la largeur du rectangle indiqué par lpRect et élargir la base du rectangle de lié à la dernière ligne de texte. Si il n'y a qu'une seule ligne de texte, DrawText modifiera le côté droit du rectangle afin qu'il limite le dernier caractère de la ligne. Dans les deux cas, DrawText retourne la hauteur du texte formaté, mais n'attire pas le texte.
DT_CE&NTERnbsp ; Centre le texte horizontalement.
DT_E&ND_ELLIPSIS ou DT_PATH_ELLIPSISnbsp ;Remplace une partie de la chaîne avec des ellipses, si nécessaire, afin que le résultat s'inscrit dans le rectangle spécifié. La chaîne n'est pas modifiée à moins que l'indicateur DT_MODIFYSTRING est spécifié.
Vous pouvez spécifier DT_END_ELLIPSIS pour remplacer des caractères à la fin de la chaîne, ou DT_PATH_ELLIPSIS pour remplacer les caractères de la chaîne. Si la chaîne contient des caractères de barre oblique inverse (\), le DT_PATH_ELLIPSIS conserve autant que possible du texte après la dernière barre oblique inverse.
DT_EXPA&NDTABSnbsp ; Développe des caractères de tabulation. Le nombre de caractères par tabulation par défaut est de huit.
DT_EXTER&NALLEADINGnbsp ; Comprend leader externe de la police à la hauteur de ligne. Normalement, le leader externe n'est pas inclus dans la hauteur d'une ligne de texte.
DT_LEFT ; Aligne le texte flush-gauche.
DT_MODIFYSTRI&NGnbsp ;Modifie la chaîne donnée pour faire correspondre le texte affiché. Cet indicateur n'a aucun effet à moins que l'indicateur DT_END_ELLIPSIS ou DT_PATH_ELLIPSIS est spécifié.
Note Certaines combinaisons de drapeau de uFormat peuvent provoquer la chaîne passée à être modifiée. À l'aide de DT_MODIFYSTRING avec DT_END_ELLIPSIS ou DT_PATH_ELLIPSIS peut provoquer la chaîne à être modifiés, causant une affirmation dans le CString override.
DT_&NOCLIPnbsp ; Tirages sans coupure. DrawText est quelque peu plus rapide lorsque la DT_NOCLIP est utilisée.
DT_NOPREFIXnbsp ; Désactive le traitement des caractères de préfixe. Normalement, les DrawText interprète le caractère de préfixe mnémonique perluète (&) comme une directive pour souligner le caractère qui suit et les deux-(& &) caractères de préfixe mnémonique comme une directive pour imprimer une perluète unique. Ce traitement est désactivé en spécifiant DT_NOPREFIX,.
DT_PATH_ELLIPSISnbsp ; & nbsp;
DT_RIGHT ; Aligne le texte flush-droit.
DT_SI&NGLELINEnbsp ; Spécifie la ligne seulement. Les retours chariot et les sauts de ligne n'interrompez pas la ligne.
DT_TABSTOP ; Définit des taquets de tabulation. L'octet de l'ordre de nFormat est le nombre de caractères pour chaque onglet. Le nombre de caractères par tabulation par défaut est de huit.
DT_TOP ; Spécifie le texte justifié de haut (seule ligne uniquement).
DT_VCE&NTERnbsp ; Spécifie le texte centré verticalement (seule ligne uniquement).
DT_WORDBREAK ; Spécifie la césure. Les lignes sont automatiquement rompus entre les mots, si un mot s'étendrait au-delà du bord du rectangle spécifié par lpRect. Une séquence de return–linefeed de transport sera aussi briser la ligne.

&Notenbsp ;Les valeurs DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIPet DT_NOPREFIX ne peut pas être utilisées avec la valeur DT_TABSTOP.

Remarques

Appelez cette fonction membre pour mettre en forme le texte dans le rectangle donné. Il met le texte en élargissant les onglets dans les espaces appropriés, aligner le texte à gauche, à droite, ou le Centre du rectangle donné et briser le texte dans les lignes qui correspondent à l'intérieur du rectangle donné. Le type de mise en forme spécifié par nFormat.

Cette fonction membre utilise le contexte de périphérique police sélectionnée, couleur du texte et couleur d'arrière-plan pour dessiner le texte. À moins que le format DT_NOCLIP est utilisé, DrawText clips le texte afin que le texte n'apparaît pas à l'extérieur du rectangle donné. Toute mise en forme est supposée pour avoir plusieurs lignes, à moins que le format DT_SINGLELINE est donné.

Si la police sélectionnée est trop grande pour le rectangle spécifié, la fonction de membre de DrawText n'essaie pas de se substituer à une police plus petite.

Si l'indicateur DT_CALCRECT est spécifié, le rectangle spécifié par lpRect sera mis à jour pour tenir compte de la largeur et la hauteur nécessaires pour dessiner le texte.

Si l'indicateur d'alignement de texte TA_UPDATECP a été défini (voir CDC::SetTextAlign), DrawText affiche texte commençant à la position actuelle, plutôt qu'à la gauche du rectangle donné. DrawText va envelopper pas de texte lorsque l'indicateur TA_UPDATECP est défini (c'est le drapeau DT_WORDBREAK aura aucun effet).

La couleur du texte peut être définie par CDC::SetTextColor.

Aperçu de la CDC | ; Membres de la classe | Graphique de la hiérarchie

Voir aussinbsp ;CDC::SetTextColor, CDC::ExtTextOut, CDC::TabbedTextOut, CDC::TextOut, :: DrawText, RECT, CDC::SetTextAlign

Index