Die Community zu .NET und Classic VB.
Menü

DrawText

 von 

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 Long
Weitere 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
hdcGibt den gewünschten Gerätekontext an.
lpStrZeiger auf den auszugebenden String. Ist der Parameter nCount auf -1 gesetzt muß dieser String nullterminiert sein.
nCountSpezifiziert 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.

Tabelle 1


Gängige Werte für wFormat
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_TABSTOPErlaubt 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_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
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
GrayString, TabbedTextOut, TextOut

Zugehörige Tipps

Zugehörige Microsoft Knowledge Base Artikel