Freigeben über


CDC::ExtTextOut

Rufen Sie die Memberfunktion auf, um eine Zeichenfolge in einem rechteckigen Bereichs mit der aktuell ausgewählten Schriftarten zu schreiben.

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  
);

Parameter

  • x
    Gibt die logische x-Koordinate der Zeichenzelle für das erste Zeichen in der angegebenen Zeichenfolge.

  • y
    Gibt die logische y-Koordinate für den oberen Rand der Zeichenzelle für das erste Zeichen in der angegebenen Zeichenfolge.

  • nOptions
    Gibt den Rechtecktyp an. Dieser Parameter kann einen, oder keine der folgenden Werte sein:

    • ETO_CLIPPED gibt an, dass Text auf das Rechteck abgeschnitten wird.

    • ETO_OPAQUE gibt die aktuellen Hintergrundfarbenfüllbereiche das Rechteck. (Sie können die aktuellen Hintergrundfarbe mit den SetBkColor und GetBkColor-Memberfunktionen festlegen und abfragen.)

  • lpRect
    Zeigt auf RECT-Struktur, das die Abmessungen des Rechtecks bestimmt. Dieser Parameter kann NULL sein. Sie können ein CRect-Objekt für diesen Parameter übergeben.

  • lpszString
    Punkte der angegebenen Zeichenfolge gezeichnet werden. Sie können ein CString-Objekt für diesen Parameter übergeben.

  • nCount
    Gibt die Anzahl der Zeichen in der Zeichenfolge.

  • lpDxWidths
    Zeigt auf einem Array von Werten, die den Abstand zwischen Ursprüngen von Zellen des angrenzenden Zeichens angeben. Beispielsweise trennen logische lpDxWidths[i]-Einheiten die Ursprünge der Zeichenzelle i und der Zeichenzelle i + 1. Wenn lpDxWidthsNULL ist, verwendet ExtTextOut den standardmäßigen Abstand zwischen Zeichen.

  • str
    Ein CString-Objekt, das die angegebenen gezeichnet werden Zeichen enthält.

Rückgabewert

Ungleich 0 (null), wenn die Funktion erfolgreich; 0 andernfalls.

Hinweise

Der rechteckige Bereich kann nicht transparent sein (gefüllt mit der aktuellen Hintergrundfarbe), und es kann ein Clippingbereich sein.

Wenn nOptions 0 ist und lpRectNULL ist, schreibt die Funktion Text an den Gerätekontext, ohne einen rechteckigen Bereich zu verwenden. Standardmäßig wird die aktuelle Position nicht von der Funktion verwendet oder aktualisiert. Wenn eine Anwendung die aktuelle Position aktualisieren muss, wenn sie ExtTextOut aufruft, kann die Anwendung die CDC-Memberfunktion SetTextAlign mit nFlags aufrufen, das zu TA_UPDATECP festgelegt ist. Wenn dieses Flag festgelegt ist, ignoriert Windows x und y bei nachfolgenden Aufrufen von ExtTextOut sowie die aktuelle Position stattdessen. Wenn eine Anwendung TA_UPDATECP verwendet, um die aktuelle Position zu aktualisieren, legt ExtTextOut entweder die aktuelle Position zum Ende der vorherigen Textzeile oder der Position ab, die durch das letzte Element des Arrays angegeben wird, das auf durch lpDxWidths dargestellt wird, das größer ist.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchiediagramm

CDC::SetTextAlign

CDC::TabbedTextOut

CDC::TextOut

CDC::GetBkColor

CDC::SetBkColor

CDC::SetTextColor

ExtTextOut

RECT-Struktur