Name
UI_INFIELD

Syntax
UI_INFIELD "name", x, y, breite, höhe [,
methode, bildname,
bilderanzahl, reihen,
zelleX, zelleY, bildX, bildY,
ausdruck1, text1 [, ...
ausdruckn, textn]] [
UI_TOOLTIP tooltipptext]

Aufklappen Wertebereiche
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)

Aufklappen 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.

Aufklappen 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.

Es lässt sich nicht der mit Archicad 23 eingeführte Dictionary-Parameter über UI_INFIELD befüllen.

Aufklappen ArchiCAD
ab 6.5