Name
UI_BUTTON

Syntax
UI_BUTTON UI_PREV, text, x, y, breite, höhe [, id] [UI_TOOLTIP tooltipptext]
oder
UI_BUTTON  UI_NEXT, text, x, y, breite, höhe [, id] [UI_TOOLTIP tooltipptext]
oder (ab ArchiCAD 10)
UI_BUTTON UI_LINK, text, x, y, breite, höhe [, id [, URL]] [UI_TOOLTIP tooltipptext]
oder (ab ArchiCAD 10)
UI_BUTTON UI_FUNCTION, text, x, y, breite, höhe [, id] [UI_TOOLTIP tooltipptext]

Aufklappen Wertebereiche
text, Typ string
x ≥ 0, Typ integer
y ≥ 0, Typ integer
breite ≥ 0, Typ integer
höhe ≥ 0, Typ integer
id ≥ 0, eindeutiger Identifizierer, Typ integer (ab ArchiCAD® 10)
URL, Gültige Webadresse, Typ string (ab ArchiCAD® 10)
tooltipptext, Typ string (ab ArchiCAD® 10)

Aufklappen Erläuterung
Erzeugt ein Schaltflächensymbol, mit dem man im User Interface von Seite zu Seite blättern kann. Hierzu müssen verschiedene Seiten durch mehrere Befehle des Typs UI_PAGE definiert werden.

Es gibt 4 Typen:
UI_PREV: klickt man hierauf, wird eine Seite zurückgeblättert
UI_NEXT: klickt man hierauf, wird eine Seite vorgeblättert
UI_LINK: klickt man hierauf, wird automatisch der Standardbrowser gestartet und die unter URL eingetragene Webadresse wird aufgerufen. (ab ArchiCAD® 10)
UI_FUNCTION: klickt man hierauf wird die Globale Variable GLOB_UI_BUTTON_ID auf den Wert gesetzt, der der id der Schaltfläche entspricht. (ab ArchiCAD® 10)

Die Schaltfläche zeigt text als Beschriftung.
Die Variablen x und y sind die Koordinaten der linken oberen Ecke der Schaltfläche im User Interface (Angabe in Pixeln).
Die Variablen breite und höhe geben die Breite und Höhe der Schaltfläche in Pixeln an.

Die id ist für die Variante UI_FUNCTION ein eindeutiger Identifizierer, welcher die Globale Variable GLOB_UI_BUTTON_ID auf den id-Wert der zuletzt angeklickten Schaltfläche setzt.
Die URL gilt nur für die Variante UI_LINK; hier ist eine gültige Webadresse in Anführungszeichen (oder eine entsprechende Variable) einzutragen.

Ab ArchiCAD 10 kann mit dem optionalen Appendix UI_TOOLTIP eine "Fly over"-Information eingeblendet werden. Siehe separate Beschreibung.

Aufklappen Beispiel
UI_BUTTON UI_NEXT, "Seite 3", 180,238,126,24,1
UI_BUTTON UI_PREV, "Seite 1", 3,238,126,24,2
UI_BUTTON UI_LINK, "unsere Website", 3,238,126,24,3,"http://www.selfgdl.de"
UI_BUTTON UI_FUNCTION, "Seite 4", 170,150,50,20,4

Aufklappen Tipps und Tricks
Mit UI_BUTTON UI_LINK ist man sogar in der Lage, beliebige Anwendungen auf der Festplatte zu starten und nicht nur HTML-Seiten im Internet.
Z.B. startet folgender Buttton: UI_BUTTON UI_LINK, "Ein GDL-Objekt", 3,238,126,24,3,"C:\ArchiCAD\self.gsm" die in der Registrierung dafür eingetragene Anwendung, in diesem Fall ArchiCAD.

Zum Thema mehrseitige User Interfaces siehe Links unter UI_PAGE (DE)

Aufklappen ArchiCAD
ab 6.5