DrawText
von ActiveVB-Team
Deklaration
Declare Function DrawText Lib "user32" _ Alias "DrawTextA" ( _ ByVal hdc As Long, _ ByVal lpStr As String, _ ByVal nCount As Long, _ lpRect As RECT, _ ByVal wFormat As Long) As LongWeitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel DrawText des API-Wikis.
DrawText zeichnet den angegebenen Text und formatiert die Ausgabe wie vorgegeben.
Parameter | |
---|---|
hdc | Gibt den gewünschten Gerätekontext an. |
lpStr | Zeiger auf den auszugebenden String. Ist der Parameter nCount auf -1 gesetzt muß dieser String nullterminiert sein. |
nCount | 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. |
Tabelle 1
Gängige Werte für wFormat | |
---|---|
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_TABSTOP | Erlaubt die Veränderung der Standard-Tabulatoreinstellung. Normalerweise stehen Tabulatoren für 8 Zeichen. Mit Hilfe dieses Wertes kann diese Einstellung geändert werden. Der neue Abstand wird in den oberen 8 Bit [15-8], des Paramters wFormat mit angegeben. |
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
Win32s, Windows 95, Windows 98, Windows NT
Verwandte API-Funktionen
GrayString, TabbedTextOut, TextOut
Zugehörige Tipps
Zugehörige Microsoft Knowledge Base Artikel