Name
TEXTBLOCK

Syntax
TEXTBLOCK name breite, anker, winkel, zeichenbreite, zeichenabstand, größenbezug, absatz1 [..., absatzn]

Aufklappen Wertebereiche
name, Typ text
breite, Typ real
0 < anker < 10, Typ integer
winkel, Typ real
zeichenbreite, Typ real
zeichenabstand, Typ real
größenbezug, Typ binär
absatzi, Typ text

Aufklappen Erläuterung
Fügt aus einem oder mehreren Absätzen (PARAGRAPH) einen Textblock zusammen. Dieser wird mit diesem Befehl nicht dargestellt, sondern erst mit dem nachfolgenden Befehl RICHTEXT2 oder RICHTEXT.

Der Textblock muss für die spätere Referenz darauf einen eindeutigen Namen (name) erhalten.

Die Maximalbreite wird mit breite festgelegt. Ob das Maß absolut in mm auf dem Papier oder maßstäblich (Meter) interpretiert wird, hängt von größenbezug ab:
größenbezug=0: maßstabsabhängig; alle Größen meinen Meter im Modellraum.
größenbezug=1: nicht maßstabsabhängig; alle Größen sind in mm angegeben (= Papiergröße).
Siehe auch REQUEST ("TEXTBLOCK_INFO", ...) zum Abruf der tatsächlichen Abmessungen.
Diese Deklaration wirkt sich nicht nur auf breite aus, sondern auch auf die Interpretation der übrigen Maßangaben in den Befehlen DEFINE STYLE{2} und PARAGRAPH, mit denen die hier zusammengefassten Absätze erzeugt wurden. Da Absätze und Textblöcke mehrfach verwendet werden können, wird auch für jede Ausgabe separat die Einstellung von größenbezug angewendet.

anker gibt die Ausdehnungsrichtung an. Siehe Abbildung.

winkel neigt den kompletten Block um den Ankerpunkt.

Über den kompletten Textblock hinweg kann nun global die Zeichenbreite und die Laufweite festgelegt werden. Die Parameter zeichenbreite und zeichenabstand sind Faktoren und keine absoluten Werte. Der Wert 1 belässt die Schriftart bei ihren Proportionen wie im Zeichensatz definiert.

Die durch Kommata voneinander getrennten Absatztexte (absatzi) können Klartexte, Ergebnisse von String-Operationen, Variablen und Parameter oder Referenzen auf mit PARAGRAPH definierte Absätze sein. Die Zusammenstellung kann auch aus gemischten "Quellen" bestehen.

Aufklappen Beispiel
PARAGRAPH "Kopf" 1,
  25, 5, 0, 1.5,
  50
  "RAUM\tFLÄCHE"
  ENDPARAGRAPH

bezug = 0
TEXTBLOCK "Ausgabe" 90, 1, 0,
  1, 1, bezug,
  "Kopf","Und dies ist ein freier Text"

RICHTEXT2 0,0, "Ausgabe"


Ein ausführliches Beispiel findet sich unter RICHTEXT2.

Aufklappen Besonderheiten
Blocksatz i.V.m. Tabulatoren scheint Probleme zu Verursachen. So kommt es vor, dass der Text aus seiner definierten Breite ausbricht oder diese gar verbreitert. Auch die Positionierung des Textes an den erwarteten Tabulatorpositionen scheint dann verschoben. In ArchiCAD® 10 ist zumindest letzteres Phänomen behoben.

Aufklappen Tipps und Tricks
In dem Text sind einige Formatierungszeichen erlaubt. Sie werden auf die maximale Textlänge von 255 Zeichen pro Programmzeile angerechnet. Sonst gibt es keine Längenbeschränkung.

"\n" : Neue Zeile/Zeilenumbruch
"\t" : Tabulator
"\\" : "\" (Backslash)

Aufklappen Kontext
2D-Skript, 3D-Skript

Aufklappen ArchiCAD
ab 9.0