CDC::DrawText

Artikel
02/26/2013

Rufen Sie die Memberfunktion auf, um Text im angegebenen Rechteck zu formatieren.Um zusätzliche Formatierungsoptionen anzugeben, verwenden Sie CDC::DrawTextEx.

virtual int DrawText(
   LPCTSTR lpszString,
   int nCount,
   LPRECT lpRect,
   UINT nFormat 
);
int DrawText(
   const CString& str,
   LPRECT lpRect,
   UINT nFormat 
);

Parameter

lpszString
Zeigt auf die gezeichnet werden Zeichenfolge.Wenn nCount ist - 1, die Zeichenfolge muss auf NULL endende sein.
nCount
Gibt die Anzahl der Zeichen in der Zeichenfolge.Wenn nCount ist - 1, dann lpszString wird davon ausgegangen, dass ein langer Zeiger auf eine auf NULL endende Zeichenfolge sein und DrawText berechnet die Zeichenanzahl automatisch.
lpRect
Zeigt auf RECT-Struktur oder CRect-Objekt, das das Rechteck enthält (in logischen Koordinaten) in dem der Text formatiert werden soll.
str
Ein CString-Objekt, das die angegebenen gezeichnet werden Zeichen enthält.

nFormat
Gibt die Methode das Formatieren von Text an.Sie kann eine beliebige Kombination der Werte sein, die für den uFormat-Parameter in DrawText in Windows SDK beschrieben werden.Kombiniert (mithilfe des bitweisen OR-Operators):

Hinweis
Einige uFormat-Flagskombinationen können die übergebene Zeichenfolge bewirken geändert werden.Verwenden DT_MODIFYSTRING entweder mit DT_END_ELLIPSIS oder DT_PATH_ELLIPSIS kann die Zeichenfolge bewirken geändert werden und eine Assertion in der CString Überschreibung verursachen.Die Werte DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP und DT_NOPREFIX können nicht mit dem DT_TABSTOP-Wert verwendet werden.

Einige uFormat-Flagskombinationen können die übergebene Zeichenfolge bewirken geändert werden.Verwenden DT_MODIFYSTRING entweder mit DT_END_ELLIPSIS oder DT_PATH_ELLIPSIS kann die Zeichenfolge bewirken geändert werden und eine Assertion in der CString Überschreibung verursachen.Die Werte DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP und DT_NOPREFIX können nicht mit dem DT_TABSTOP-Wert verwendet werden.

Rückgabewert

Die Höhe des Texts, wenn die Funktion erfolgreich.

Hinweise

Sie Text formatiert, indem sie Registerkarten in die entsprechenden Leerzeichen erweitern und Text nach links ausrichten, rechten oder Mittelpunkt des Rechtecks und des angegebenen Anwendungsverhalten von Text in Zeilen diese Anpassung innerhalb des angegebenen Rechtecks.Der Typ der Formatierung wird von nFormat angegeben.

Diese Memberfunktion verwendet des ausgewählte Schriftart, Textfarbe und Hintergrundfarbe Gerätekontexts, um den Text zu zeichnen.Es sei denn, das DT_NOCLIP Format verwendet wird, schneidet DrawText den Text ab, sodass der Text nicht außerhalb des angegebene Rechteck aussieht.Alle Formatierungen wird angenommen, dass mehrere Zeilen verfügen, es sei denn, das DT_SINGLELINE Format erhält.

Wenn die ausgewählte Schriftart für das angegebene Rechteck zu groß ist, versucht die DrawText-Memberfunktion nicht, eine kleinere Schriftart zu ersetzen.

Wenn das DT_CALCRECT-Flag angegeben wird, wird das Rechteck, das durch lpRect angegeben wird, aktualisiert, um die Breite und Höhe zu berücksichtigen, die erforderlich sind, um den Text zu zeichnen.

Wenn das TA_UPDATECP Textausrichtungsflag (siehe), CDC::SetTextAlign festgelegt wurde, wird DrawText den Text an, der an der aktuellen Position, anstatt links vom angegebenen Rechteck beginnt.DrawText bindet nicht Text ein, wenn das TA_UPDATECP-Flag festgelegt wurde (das heißt, hat das DT_WORDBREAK-Flag keine Auswirkungen.)

Die Textfarbe wird durch CDC::SetTextColor festgelegt werden.