Name
UI_DIALOG

Syntax
UI_DIALOG titel [, x_größe, y_größe]

Aufklappen Wertebereiche
titel: Titel in Anführungszeichen (kann auch leer bleiben), Typ string
x_größe: ≥0 (optional), Typ integer
y_größe: ≥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. Das Interface Script darf nur einen einzigen UI_DIALOG Befehl enthalten.

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 Standardgröße beträgt seit Archicad 24 nun 460 × 266 Pixel.
Mit der Option der "Hierarchschen Seiten" ergibt sich eine Höhe von 296 Pixel; das Seitenkontrollelement nimmt also 30 Pixel ein. Sind die "Hierarchischen Seiten" nicht aktiv, ergibt sich somit ein Margin oben und unten von jeweils 15 px. Graphisoft empfiehlt jedoch keine UI-Elemente in diesem Bereich zu platzieren.

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 zudem 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, jedoch ist die maximale Breite 680 Pixel begrenzt.



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 ArchiCAD
ab 6.5