Freigeben über


CDC::TextOut

Schreibt mithilfe der aktuell ausgewählten Schriftart eine Zeichenfolge an dem angegebenen Speicherort.

virtual BOOL TextOut( 
   int x, 
   int y, 
   LPCTSTR lpszString, 
   int nCount  
); 
BOOL TextOut( 
   int x,
   int y,
   const CString& str 
);

Parameter

  • x
    Gibt die logische x-Koordinate des Anfangspunkts des Texts an.

  • y
    Gibt die logische y-Koordinate des Anfangspunkts des Texts an.

  • lpszString
    Zeigt auf die zu zeichnende Zeichenfolge.

  • nCount
    Gibt die Anzahl von Zeichen in der Zeichenfolge an.

  • str
    Ein CString-Objekt, das die zu zeichnenden Zeichen enthält.

Rückgabewert

Ist ungleich null (0), wenn die Funktion erfolgreich ausgeführt wird, andernfalls null (0).

Hinweise

Zeichenursprünge befindet sich in der oberen linken Ecke der Zeichenzelle. Standardmäßig wird die aktuelle Position von der Funktion nicht verwendet oder aktualisiert.

Wenn eine Anwendung die aktuelle Position aktualisieren muss, wenn sie TextOut aufruft, kann die Anwendung die Memberfunktion SetTextAlign aufrufen, wobei nFlags auf TA_UPDATECP festgelegt ist. Wenn dieses Kennzeichen festgelegt ist, ignoriert Windows die x- und y-Parameter bei nachfolgenden Aufrufen von TextOut und verwendet stattdessen die aktuelle Position.

Beispiel

Weitere Informationen finden Sie im Beispiel für CDC::BeginPath.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchiediagramm

CDC::ExtTextOut

CDC::GetTextExtent

CDC::SetTextAlign

CDC::SetTextColor

CDC::TabbedTextOut

TextOut