Sprache / Anweisungen – erweiterte Draw-Anweisungen – Zeichnen von Text, Codes und Grafik
DrawText
Syntax
DrawText(text, left, top, width, height[, alignment])
| Parameter | Datentyp | Beschreibung |
|---|---|---|
| Text | text | Beliebiger Text als Inhalt |
| Left | number | Abstand zum linken Rand des jeweiligen Bereichs (in Zehntelmillimetern) |
| Top | number | Abstand zum oberen Rand des jeweiligen Bereichs (in Zehntelmillimetern) |
| Width | number | Breite des Eingabebereichs (in Zehntelmillimetern) |
| Height | number | Höhe des Eingabebereichs (in Zehntelmillimetern) |
| Alignment | number | Optionaler Wert für die Textausrichtung:
|
Beschreibung
Die DrawText-Anweisung gibt einen mehrzeiligen Text aus. Ist der Text länger als die mit Draw-Text angegebene Breite, so wird der Text automatisch umgebrochen. Der Text wird unvollständig ausgegeben, wenn die Texthöhe des Feldinhaltes grösser ist als die bei DrawText angegebene Höhe. Der frei wählbare Ausgabetext muss in Anführungszeichen stehen.
Diese Anweisung ist wohl die wichtigste und meistverwendete Anweisung für personifizierte Formulare.
Wird der Text nicht oder nur unvollständig ausgegeben, kann dies folgende Ursachen haben:
Die für den Eingabebereich angegebene Höhe reicht nicht aus, um den Text vollständig darzustellen.
- Die Schriftgrösse ist grösser als die in der Anweisung DrawText angegebene Höhe.
Der mit der Anweisung SetArea definierte Bereich wird überschritten.
Optional kann die Textausrichtung (1 für links, 2 für zentriert und 3 für rechts) angegeben werden. Als Vorgabe wird der Text links ausgerichtet. Mit der Anweisung SetTextLineSpacing kann die Zeilenhöhe des mehrzeiligen Textes geändert werden. Mit der Anweisung GetTextWidth kann die Breite eines Textes bestimmt werden, wodurch mehrere Texte nebeneinander differenziert formatiert ausgegeben werden können.
Die DrawText-Anweisung kann nicht in den Bereichen BeginDocument und BeginPage verwendet werden.
Beispiel
