name, Parametername, Typ string x, y ≥ 0, Typ integer breite, höhe ≥ 0, Typ integer methode, reserviert, bis ArchiCAD® 9 immer 1 bildname, Dateiname (Typ string) oder ab ArchiCAD® 9 Bildindex (≥0 Typ integer) bilderanzahl > 0, Typ integer reihen > 0, Typ integer zelleX, zelleY ≥ 0, Typ integer bildX, bildY ≥ 0, Typ integer ausdrucki, Dateiname (Typ string) oder Bildindex (Typ integer) texti, Typ string tooltipptext, Typ string (ab ArchiCAD® 10)
Erläuterung
Erzeugt ein Texteingabefeld oder ein Popup-Menü für die Parametereingabe bzw. -Auswahl. Ein Popupfeld wird erzeugt, wenn der Parameter vom Typ Auswahlliste, Material, Schraffur, Linientyp, Stiftfarbe oder Parameter-Array ist.
Wenn Parameter durch Auswahllisten (VALUES-Befehl) begrenzt werden, können seine Popups alternativ mit Hilfe von Bildkatalogen, die die Parameterwerte repräsentieren, angezeigt werden.
Bildkataloge zeigen die ausgewählten Bilder und den damit assoziierten Text an, besitzen eine senkrechte Bildlaufleiste (auch wenn eigentlich nicht benötigt) am rechten Rand und gestatten die Auswahl jeweils eines einzelnen Elementes, genau wie im Popup-Menü.
Das User Interface wird nach jeder Parameteränderung mit dem neuen Wert neu aufgebaut. name: Parametername als Zeichenfolge-Ausdruck für UI_INFIELD x, y: Die Position des editierbaren Textfeldes, Popups oder Steuerelementes breite, höhe: Breite und Höhe in Pixeln. versionsmarke: reserviert, zur Zeit immer 1 bildname: Name der (einen) Bilddatei, welche eine Matrix verketteter Bilder enthält, oder ab ArchiCAD® 9 ein Index auf ein im Objekt eingebettetes Bild. Wird eine leere Zeichenfolge angegeben, werden die Auswahlbilder einzeln mit ausdrucki spezifiziert. bilderanzahl: Anzahl der Bilder in der Matrix reihen: Anzahl der Reihen in der Matrix zelleX, zelleY: Breite und Höhe einer Zelle innerhalb des Bildkataloges, einschließlich Bild und Text. bildX, bildY: Breite und Höhe des Bildes innerhalb der Zelle ausdrucki: Index des i-ten Bildes in der Matrix, oder individuelle Dateinamen für jedes einzelne Auswahlbild. Falls mit bildname ein allgemeiner Bilddateiname (oder ein Index auf ein im Objekt eingebettetes Bild) angegeben wurde, müssen hier Indizes verwendet werden. Kombinationen aus Indizes und individuellen Dateinamen sind nicht zusammen möglich. texti: Text in der i-ten Zelle
Ab ArchiCAD 10 kann mit dem optionalen Appendix UI_TOOLTIP eine "Fly over"-Information eingeblendet werden. Siehe separate Beschreibung.
Besonderheiten
Folgende Arten von Feldern werden erzeugt:
- Leeres Eingabefeld für Längen, Winkel, Natürliche Zahlen, Ganzzahlen, Text (Größe abhängig von Textgröße, ansonsten in der Höhe unveränderlich)
- Ankreuzfeld (unveränderliche Größe) für Booleschen Parameter (Ankreuzbereich kann auch außerhalb des eigentlichen Feldes liegen, wenn die Größe größer als ca. 14 x 14 Pixel gewählt wird)
- Auswahlfelder (mit veränderlicher Höhe) für Linientyp, Stiftfarbe, Material, Schraffur, Array-Parameter (als Tabelle)
- Bildauswahlliste für durch VALUES erzeugte Popupparameter vom Typ "Text" und "Ganzzahl". Auch Winkel, Natürliche Zahl, Linientyp, Stiftfarbe, Material, Schraffur sind möglich, ergeben aber keinen Sinn.