|
Name
TEXTBLOCK |
Syntax TEXTBLOCKname breite, anker, winkel, zeichenbreite, zeichenabstand, größenbezug, absatz1 [..., absatzn] |
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 |
|
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: absolut größenbezug=1: maßstäblich. 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. |
|
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. |
|
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. |
|
Kontext
2D-Skript, 3D-Skript |
|
ArchiCAD®
ab 9.0 |
|
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) |
|
Referenzen
GDL-Handbuch 9.0 (DE) S.179 GDL-Handbuch 10.0 (DE) S.177 GDL-Handbuch 11.0 (DE) S.183 GDL Reference Guide 9.0 (INT) S.174 GDL Reference Guide 10.0 (INT) S.176 GDL Reference Guide 11.0 (INT) S.176 |
Abb.1: Das Zusammenspiel der Parameter von PARAGRAPH (1-6), TEXTBLOCK (7-10) und REQUEST ("TEXTBLOCK_INFO", ...) (14-15).
1: einzug1
2: einzug_links
3: einzug_rechts
4: zeilenabstand
5: tabulator1
6: tabulator2
7: breite (nominal)
8: anker
9: Breite der Zeichen = C*zeichenbreite
10: Abstand der Zeichen = C*zeichenabstand
11: Zeichenbreite (C) nach Zeichensatzdefinition (systemdedingt).
12: zeichenhöhe. Siehe DEFINE STYLE{2}.
13: schrifthöhe. Siehe REQUEST ("HEIGHT_OF_STYLE", ...).
14: textbreite. Siehe REQUEST ("TEXTBLOCK_INFO", ...).
15: texthöhe. Siehe REQUEST ("TEXTBLOCK_INFO", ...).
Alle Werte sind abhängig von größenbezug.
Abb.2: Positionierung des Textes in Bezug zu anker.
