Die Community zu .NET und Classic VB.
Menü

DrawTextEx

 von 

Deklaration  

Declare Function DrawTextEx Lib "user32" _
                 Alias "DrawTextExA" ( _
                 ByVal hDC As Long, _
                 ByVal lpsz As String, _
                 ByVal n As Long, _
                 lpRect As RECT, _
                 ByVal wFormat As Long, _
                 lpDrawTextParams As Any) As Long
Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel DrawTextEx des API-Wikis.

DrawTextEx zeichnet den angegebenen Text und formatiert die Ausgabe wie vorgegeben.

Parameter
hdcGibt den gewünschten Gerätekontext an.
lpszZeiger auf den auszugebenden String. Ist der Parameter nCount auf -1 gesetzt muß dieser String nullterminiert sein.
nSpezifiziert die Anzahl der zu zeichnenden Zeichen. Ist dieser Wert gleich -1, handelt es sich um einen nullterminierten String.
lpRectDefiniert das umgrenzende Rechteck. Der Text wird innerhalb dieses Rechtecks formatiert.
wFormatGibt verschiedene Flags an, die das Formatieren steuern. Diese Parameter kann eineKombination der aus den in der untenstehenden Tabelle aufgelisteten Werte annehmen.
lpDrawTextParamsEin Zeiger auf eine DRAWTEXTPARAMS Struktur, die zusätzliche Formatinformationen und Rückgabewerte enthält. Dieser Parameter darf Null sein.

Tabelle 1


Gängige Werte für wFormat
DT_EDITCONTROLFormatiert Text und zeigt ihn an wie in einem Bearbeitungsfeld. Zeileninhalt der nicht in das vorgegebene Rechteck paßt, wird nicht angezeigt.
DT_ENDELLIPSISWenn der angegebene String nich in das vorgegebene Rechteck paßt, werden am Ende drei Punkte [...] angezeigt. Wenn DT_MODIFYSTRING angegeben ist, wir der veränderte String in den Puffer zurückgeschrieben auf den lpsz verweist. Dieses Flag kann nicht im Zusammenhang mit DT_PATHELLIPSIS angegeben werden.
DT_PATHELLIPSISWenn der vorgebene String nicht in das Rechteck paßt, werden in der Mitte des Strings drei Pinkte [...] angezeigt. Wenn DT_MODIFYSTRING angegeben ist, wird der veränderte String in dem Puffer zurückgegeben auf den lpsz zeigt. Dieses Flag kann nicht zusammen mit DT_ENDELLIPSIS angegeben werden. Wenn der String einen Backslash enthält, wird so viel wie möglich vom Stringende behalten, da es sich möglicherweise um einen Dateinamen handeln könnte.
DT_MODIFYSTRINGWenn dieses Flag zusammen mit DT_PATHELLIPSIS oder DT_ENDELLIPSIS angegeben wird, weist das DrawTextEx an , den modifizierten String in dem Puffer zurückzugeben, auf den lpsz verweist.
DT_RTLREADINGWenn im Gerätekontext die Schrift Arabic oder Hebrew angegeben ist, wird der Text von rechts nach links angezeigt.
DT_TABSTOPDieses Flag ist ähnlich DT_TABSTOP, das für DrawText verwendet wird, außer das Tabstops basierend auf den Wert gesetzt werden, der in der Struktur angelegt ist, auf die lpDrawTextParams zeigt.
DT_BOTTOMDieser Text wird an der unteren Kante des angegebenen Rechtecks ausgerichtet. DT_SINGLELINE muß ebenfalls angegeben sein.
DT_CALCRECTDieser Text wird nicht gezeichnet. Stattdessen berechnet DrawText die Größe des erforderlichen Rechtecks. Enthält der Text mehrere Zeilen, wird die Breites des angegebenen Rechtecks verwendet, und die Höhe des Rechtecks wird soweit vergrößert, daß alle Textzeilen hineinpassen. Wenn nur eine Textzeile vorhanden ist, wird die rechte Seite des Rechecks soweit verschoben, daß es den gesamten String aufnehmen kann.
DT_CENTERDie Textzeilen werden innerhalb des umgrenzenden Rechtecks horizontal zentriert.
DT_EXPANDTABSGibt an das Tabulatorzeichen innerhalb des umgrenzenden Rechtecks exoandiert werden sollen. Die Standardeinstellung für Tabulatoren beträgt 8 Zeichen.
DT_EXTERNALLEADINGBerücksichtigt den Linienabstand für die Berechnung der Zeilenhöhe.
DT_LEFTDie Textzeilen werden linksbündig ausgerichtet.
DT_NOCLIPDer Text wird ohne Abschneiden gezeichnet, wodurch DrawText etwas schneller wird.
DT_NOPREFIXGibt an, daß Ampersand-Zeichen [&] im Text nicht als Präfixzeichen interpretiert werden. Normalerweise werden diese Zeichen übersprungen und das darauffolgende Zeichen unterstrichen dargestellt.
DT_RIGHTDie Textzeilen werden rechtsbündig ausgerichtet.
DT_SINGLELINEGibt an, daß CR und LF ignoriert werden. Der Text wird in einer einzigen Zeile dargestellt.
DT_TOPGibt an, daß der Text an der oberen Kante des umgrenzenden Rechtecks ausgerichtet werden soll. Dieses Flag muß in Verbindung mit DT_SINGLELINE angegeben werden.
DT_VCENTERGibt an, daß der Text im umgrenzenden Rechteck vertikal zentriert werden soll. Dieses Flag muß in Verbindung mit DT_SINGLELINE angegeben werden.
DT_WORDBREAKGibt an, daß Zeilen am Ende des letzten Wortes, welches horizontal in das Rechteck paßt, umgebrochen werden soll. Der Textstring wird wird it dem nächsten Wort in der nächsten Zeile des Rechtecks fortgesetzt. CR und LF brechen die Zeile ebenfalls um.

Tabelle 2


Rückgabewerte
HeightDie Höhe des formatierten Textes
0Es trat ein Fehler auf.

Tabelle 3


Unterstützte Betriebssysteme
Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
DrawText

Zugehörige Tipps