CDC::ExtTextOut

Article
03/04/2013

Appelez la fonction membre pour écrire une chaîne dans une zone rectangulaire à l'aide de la police sélectionnée.

virtual BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   LPCTSTR lpszString,
   UINT nCount,
   LPINT lpDxWidths 
);
BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   const CString& str,
   LPINT lpDxWidths 
);

Paramètres

x
Spécifie la coordonnée x logique de caractère pour le premier caractère de la chaîne spécifiée.
y
Spécifie l'ordonnée logique du haut de caractère pour le premier caractère de la chaîne spécifiée.
nOptions
Spécifie le type du rectangle.Ce paramètre peut être l'une, ou aucun des valeurs suivantes :
- ETO_CLIPPED spécifie que texte est découpé au rectangle.
- ETO_OPAQUE spécifie que la couleur d'arrière-plan actuelle remplit le rectangle.(Vous pouvez définir et interroger la couleur d'arrière-plan actuelle avec les fonctions membres de SetBkColor et de GetBkColor .)
lpRect
Pointe vers une structure de RECT qui détermine les dimensions du rectangle.Ce paramètre peut être NULL.Vous pouvez également passer un objet de CRect pour ce paramètre.
lpszString
Pointe vers la chaîne spécifiée à dessiner.Vous pouvez également passer un objet de CString pour ce paramètre.
nCount
Spécifie le nombre de caractères dans la chaîne.
lpDxWidths
Pointe vers un tableau de valeurs qui indiquent la distance entre les origines des cellules de caractère adjacentes.Par exemple, les unités logiques d' lpDxWidthsI[] sépareront les origines de caractère i et de caractère i + 1.Si lpDxWidths est NULL, ExtTextOut utilise l'espacement par défaut entre les caractères.
str
Un objet d' CString qui contient les caractères spécifiés à dessiner.

Valeur de retour

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

Notes

La zone rectangulaire peut être opaque (rempli avec la couleur d'arrière-plan), et ce peut être une zone de découpage.

Si nOptions est 0 et lpRect est NULL, écrit de fonction du texte au contexte de périphérique sans utiliser une zone rectangulaire.Par défaut, la position actuelle n'est pas utilisée ou n'est pas mise à jour par la fonction.Si une application doit mettre à jour la position actuelle lorsqu'il appelle ExtTextOut, l'application peut appeler la fonction membre SetTextAlign d' CDC avec nFlags affectez à TA_UPDATECP.Lorsque cette balise est définie, les fenêtres ignore x et y sur les appels suivants à ExtTextOut et utilise la position actuelle à la place.Lorsqu'une application utilise TA_UPDATECP pour mettre à jour la position actuelle, ExtTextOut définit la position actuelle à la fin de la ligne de texte précédente ou à la position spécifiée par le dernier élément du tableau pointée pointe vers lpDxWidths, celui qui est supérieur.