DrawTextEx
von ActiveVB-Team
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 LongWeitere 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 | |
---|---|
hdc | Gibt den gewünschten Gerätekontext an. |
lpsz | Zeiger auf den auszugebenden String. Ist der Parameter nCount auf -1 gesetzt muß dieser String nullterminiert sein. |
n | Spezifiziert die Anzahl der zu zeichnenden Zeichen. Ist dieser Wert gleich -1, handelt es sich um einen nullterminierten String. |
lpRect | Definiert das umgrenzende Rechteck. Der Text wird innerhalb dieses Rechtecks formatiert. |
wFormat | Gibt verschiedene Flags an, die das Formatieren steuern. Diese Parameter kann eineKombination der aus den in der untenstehenden Tabelle aufgelisteten Werte annehmen. |
lpDrawTextParams | Ein 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_EDITCONTROL | Formatiert Text und zeigt ihn an wie in einem Bearbeitungsfeld. Zeileninhalt der nicht in das vorgegebene Rechteck paßt, wird nicht angezeigt. |
DT_ENDELLIPSIS | Wenn 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_PATHELLIPSIS | Wenn 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_MODIFYSTRING | Wenn 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_RTLREADING | Wenn im Gerätekontext die Schrift Arabic oder Hebrew angegeben ist, wird der Text von rechts nach links angezeigt. |
DT_TABSTOP | Dieses 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_BOTTOM | Dieser Text wird an der unteren Kante des angegebenen Rechtecks ausgerichtet. DT_SINGLELINE muß ebenfalls angegeben sein. |
DT_CALCRECT | Dieser 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_CENTER | Die Textzeilen werden innerhalb des umgrenzenden Rechtecks horizontal zentriert. |
DT_EXPANDTABS | Gibt an das Tabulatorzeichen innerhalb des umgrenzenden Rechtecks exoandiert werden sollen. Die Standardeinstellung für Tabulatoren beträgt 8 Zeichen. |
DT_EXTERNALLEADING | Berücksichtigt den Linienabstand für die Berechnung der Zeilenhöhe. |
DT_LEFT | Die Textzeilen werden linksbündig ausgerichtet. |
DT_NOCLIP | Der Text wird ohne Abschneiden gezeichnet, wodurch DrawText etwas schneller wird. |
DT_NOPREFIX | Gibt an, daß Ampersand-Zeichen [&] im Text nicht als Präfixzeichen interpretiert werden. Normalerweise werden diese Zeichen übersprungen und das darauffolgende Zeichen unterstrichen dargestellt. |
DT_RIGHT | Die Textzeilen werden rechtsbündig ausgerichtet. |
DT_SINGLELINE | Gibt an, daß CR und LF ignoriert werden. Der Text wird in einer einzigen Zeile dargestellt. |
DT_TOP | Gibt 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_VCENTER | Gibt an, daß der Text im umgrenzenden Rechteck vertikal zentriert werden soll. Dieses Flag muß in Verbindung mit DT_SINGLELINE angegeben werden. |
DT_WORDBREAK | Gibt 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 | |
---|---|
Height | Die Höhe des formatierten Textes |
0 | Es trat ein Fehler auf. |
Tabelle 3
Unterstützte Betriebssysteme
Windows 95, Windows 98, Windows NT
Verwandte API-Funktionen
DrawText
Zugehörige Tipps