Partager via


CDC::ExtTextOut

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.

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CDC, classe

Graphique de la hiérarchie

CDC::SetTextAlign

CDC::TabbedTextOut

CDC::TextOut

CDC::GetBkColor

CDC::SetBkColor

CDC::SetTextColor

ExtTextOut

Structure RECT