Sprache 2024

Sprache / Anweisungen – erweiterte Draw-Anweisungen – Zeichnen von Text, Codes und Grafik

DrawTextWithLink

Syntax

DrawTextWithLink("url-alias", "url", left, top, width, hight[, alignment])


ParameterDatentypBeschreibung
URL-AliastextBeliebiger Text für URL-Bezeichnung
URLtextURL
InhalttextBeliebiger Text
LeftnumberAbstand zum linken Rand des jeweiligen Bereichs (in Zehntelmillimetern)
TopnumberAbstand zum oberen Rand des jeweiligen Bereichs (in Zehntelmillimetern)
WidthnumberBreite des Eingabebereichs (in Zehntelmillimetern)
HightnumberHöhe des Eingabebereichs (in Zehntelmillimetern)
AlignmentnumberOptionaler Wert für die Textausrichtung:
  • 1 links
  • 2 zentriert
  • 3 rechts


Beschreibung

Die DrawTextWithLink-Anweisung gibt einen Text mit einem Link aus. Der Text wird entsprechend der Breite des angegebenen Eingabebereichs automatisch umgebrochen. Der frei wählbare URL-Alias und die URL müssen in Anführungszeichen stehen. Die Verlinkung zur URL ist nur bei PDF-Ausgabe möglich.

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 DrawTextWithLink angegebene Höhe.
  • Der mit der Anweisung SetArea definierte Bereich wird überschritten.

Optional kann die Textausrichtung (1 für linksbündig, 2 für zentriert und 3 für rechtsbündig) angegeben werden. Standardmässig wird der Text linksbündig ausgerichtet. Die Zeilenhöhe des Textes kann mit der Anweisung SetTextLineSpacing 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 DrawTextWithLink-Anweisung kann nicht in den Bereichen BeginDocument und BeginPage verwendet werden.


Beispiel