Name
UI_DIALOG

Syntax
UI_DIALOG titel [, größe_x, größe_y]

Aufklappen Wertebereiche
titel: Titel in Anführungszeichen (kann auch leer bleiben), Typ string
größe_x: ≥0 (optional), Typ integer
größe_y: ≥0 (optional), Typ integer

Aufklappen Erläuterung
Dieser Befehl ist für die Erstellung eines User Interface zwingend erforderlich. Er gibt an, dass man ein User Interface erstellen möchte, legt seine Größe und den Titel der Eingabemaske fest.

Bis ArchiCAD 7.0 ist die durch größe_x und größe_y definierte Größe auf 310 x 266 Pixel beschränkt. Ab ArchiCAD 8.0 liegt diese Größe bei 444 x 266 Pixeln. Ab ArchiCAD 15 ist eine beliebige Breite erlaubt.

Die Angabe der Größe ist optional und kann auch weggelassen werden (die Eingabefelder werden auch nicht durch kleinere Größen beschränkt). Ab ArchiCAD 13 kann können auch die Modelleinstellungen User-Interfaces enthalten. Diese sind in der Größe nicht mehr so starr beschränkt. Die Optionen-Tabs der ArchiCAD-Bibliothek haben eine Abmessung von 600 x 410 Pixel. Eigene Tabs können größer definiert werden. Eine Beschränkung ist bisher nicht dokumentiert.

Das Interface Script darf nur einen einzigen UI_DIALOG Befehl enthalten.

Aufklappen Beispiel
UI_DIALOG "GDL-Objekt", 444,266

Aufklappen Besonderheiten
In ArchiCAD 6.5 und 7.0 erscheint der Titel innerhalb des User Interfaces am oberen Rand, welcher vom Titel durchschnitten wird. Seit ArchiCAD 8 erscheint der Titel als Überschrift im Darstellungs-Dialogfenster anstelle des standardmäßigen Eintrages "Individuelle Einstellungen", welcher grau hinterlegt ist, wenn kein User Interface Script existiert. Dynamisch veränderte Dialogüberschriften (durch die Verwendung von Variablen als titel) sind ab ArchiCAD 8 auch nicht mehr möglich. Der Name der UI-Sektion im Dialog entspricht stets dem beim Aufruf des Dialogs eingestellten.

Aufklappen Tipps und Tricks
Es ist seit ArchiCAD® 8.0 möglich, die Breite des User-Interface über die standardmäßigen 444 Pixel Breite zu vergrößern, indem man bei den Objekt-Auswahl-Einstellungen den linken Bereich ausblendet; dann kann man das Dialogfenster nach rechts auseinanderziehen.

Aufklappen ArchiCAD
ab 6.5