CDC::DrawText

virtuelleintDrawText (nFormatLPCTSTRLpszString,IntnCount,LPRECTLpRect,UINT);

Int Dr&awText (const CStringamp;StrLPRECTlpRectUINTnFormat );

Rückgabewert

Die Höhe des Textes wenn die Funktion erfolgreich ist.

Parameter

lpszString

Verweist auf die Zeichenfolge gezeichnet werden soll. Wenn nCount -1 ist, muss die Zeichenfolge Null-terminierte sein.

nCount

Gibt die Anzahl der Zeichen in der Zeichenfolge. Wenn nCount -1 ist, wird dann als LpszString angenommen, dass ein langer Zeiger auf eine Null-terminierte Zeichenfolge und DrawText automatisch die Anzahl der Zeichen berechnet.

lpRect

Verweist auf eine RECT -Struktur oder CRect -Objekt, das das Rechteck (in logischen Koordinaten) enthält, in dem der Text formatiert werden soll.

str

&Nbsp;Ein CString -Objekt mit die angegebenen Zeichen gezeichnet werden.

nFormat

Gibt die Methode der Textformatierung. Es kann eine beliebige Kombination der folgenden Werte (mithilfe der bitweisen OR-Operator kombinieren):

DT_BOTTOM&Nbsp; Unten ausgerichteter Text gibt. Dieser Wert muss mit DT_SINGLELINE kombiniert werden.
DT_CALCRECT&Nbsp; Die Breite und Höhe des Rechtecks bestimmt. Sind mehrere Zeilen Text, DrawText verwendet die Breite des Rechtecks, auf den LpRect und erweitern die Basis des Rechtecks, das auf die letzte Zeile des Textes gebunden. Wenn nur eine Zeile Text vorliegt, wird DrawText der rechten Seite des Rechtecks ändern, sodass es das letzte Zeichen in der Zeile umschließt. In beiden Fällen DrawText gibt die Höhe des formatierten Texts zurück, sondern zieht nicht den text.
DT_CE&NTERNbsp; Text zentriert horizontal.
DT_E&ND_ELLIPSIS oder DT_PATH_ELLIPSISnbsp;Ersetzt einen Teil einer Zeichenkette mit Ellipsen, falls erforderlich, damit das Ergebnis in das angegebene Rechteck passt. Die angegebene Zeichenfolge wird nicht geändert, es sei denn, das DT_MODIFYSTRING -Flag angegeben ist.
Sie können DT_END_ELLIPSIS Zeichen am Ende der Zeichenfolge zu ersetzen, oder DT_PATH_ELLIPSIS Ersetzen von Zeichen in der Mitte der Zeichenfolge angeben. Wenn die Zeichenfolge enthält einen umgekehrten Schrägstrich (\), behält DT_PATH_ELLIPSIS des Textes so weit wie möglich nach dem letzten umgekehrten Schrägstrich.
DT_EXPA&NDTABSNbsp; Erweitert Tabstoppzeichen. Die Standardanzahl von Zeichen pro Registerkarte ist acht.
DT_EXTER&NALLEADINGNbsp; Enthält die Schriftart externe führende in die Zeilenhöhe. Externe führende gehört normalerweise nicht in die Höhe einer Textzeile.
DT_LEFT&Nbsp; Richtet Text Flush-Links.
DT_MODIFYSTRI&NGnbsp;Ändert die angegebene Zeichenfolge entsprechend den angezeigten Text. Dieses Flag hat keine Auswirkungen, wenn die DT_END_ELLIPSIS oder DT_PATH_ELLIPSIS -Flag angegeben ist.
Hinweis Einige uFormat -Flag-Kombinationen können dazu führen, dass die übergebene Zeichenfolge geändert werden. Mit DT_MODIFYSTRING mit DT_END_ELLIPSIS oder DT_PATH_ELLIPSIS kann verursachen die Zeichenfolge geändert werden, verursachen eine Assertion in der CString überschreiben.
DT_&NOCLIPNbsp; Zeichnet ohne Clipping. DrawText ist etwas schneller, wenn DT_NOCLIP verwendet wird.
DT_NOPREFIXNbsp; Deaktiviert die Verarbeitung von Präfixzeichen. Normalerweise DrawText interpretiert das kaufmännische und-Zeichen (&) mnemonische Präfixzeichen als eine Richtlinie den Charakter zu unterstreichen, die folgt, und das zwei-kaufmännische und-Zeichen (& &) mnemonische Präfixzeichen als eine Richtlinie für ein einzelnes kaufmännisches und-Zeichen drucken. Wenn Sie DT_NOPREFIXangeben, wird diese Verarbeitung deaktiviert.
DT_PATH_ELLIPSISnbsp; & nbsp;
DT_RIGHT&Nbsp; Richtet Text Flush-Recht.
DT_SI&NGLELINENbsp; Nur einzelne Zeile angibt. Wagenrückläufe und Zeilenvorschübe brechen nicht die Zeile.
DT_TABSTOP&Nbsp; Tabstopps festgelegt. Das höchstwertige Byte des nFormat ist die Anzahl der Zeichen für jede Registerkarte. Die Standardanzahl von Zeichen pro Registerkarte ist acht.
DT_TOP&Nbsp; Gibt den Text oben ausgerichtet (nur einzelne Zeile).
DT_VCE&NTERNbsp; Gibt an, vertikal zentrierten Text (nur einzelne Zeile).
DT_WORDBREAK&Nbsp; Wörtertrennung gibt. Linien sind zwischen den Wörtern automatisch unterbrochen, wenn ein Wort über den Rand des Rechtecks durch LpRectangegebenen verlängern würde. Eine Wagenrücklauf Return – linefeed Sequenz wird auch der Zeilenumbruch.

&Notenbsp;Die Werte DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIPund DT_NOPREFIX können nicht mit dem DT_TABSTOP -Wert verwendet werden.

Bemerkungen

Rufen Sie diese Memberfunktion um das Formatieren von Text im angegebenen Rechteck. Sie formatiert Text durch Tabs in entsprechenden Räumen, Ausrichten von Text an der linken, rechten oder Mittelpunkt des angegebenen Rechtecks zu expandieren, und brechen Text in Zeilen, die innerhalb des angegebenen Rechtecks passen. Die Art der Formatierung wird durch nFormat angegeben.

Dieser Member-Funktion verwendet des Gerätekontexts ausgewählte Schriftart, Textfarbe und Hintergrundfarbe zum Zeichnen von Text. Es sei denn, das DT_NOCLIP -Format verwendet wird, schneidet DrawText Text, so dass der Text nicht außerhalb des angegebenen Rechtecks angezeigt wird. Alle Formatierung wird angenommen, dass mehrere Zeilen haben, soweit das DT_SINGLELINE -Format vorliegt.

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

Wenn das DT_CALCRECT -Flag angegeben ist, wird das durch LpRect angegebene Rechteck aktualisiert entsprechend die Breite und Höhe notwendig, um den Text zu zeichnen.

Wenn das Flag TA_UPDATECP Text-Ausrichtung (siehe CDC::SetTextAlign) festgelegt wurde, wird DrawText Text beginnend an der aktuellen Position, anstatt auf der linken Seite des angegebenen Rechtecks angezeigt. DrawText wird Text nicht umbrochen, wenn das TA_UPDATECP -Flag festgelegt wurde (d. h., das DT_WORDBREAK -Flag hat keine Auswirkungen).

Die Farbe des Textes may be set by CDC::SetTextColor.

Übersicht über die CDC | Member der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;TextOut, CDC::SetTextColor, CDC::ExtTextOut, CDC::TabbedTextOut :: DrawText, RECT, CDC::SetTextAlign

Index