CDC::ExtTextOut

Artikel
02/26/2013

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.