Name
UI_CUSTOM_POPUP_INFIELD{2}

Syntax
UI_CUSTOM_POPUP_INFIELD{2} "name", x, y, breite, höhe,
verborgeneIDnutzen, baumtiefe, gruppierMethode, anzeigename,
wert1, wert2, .... wertn

Aufklappen Wertebereiche
name, Parametername, Typ string
x, y ≥ 0, Postion im UI, Typ integer
breite, höhe ≥ 0, Typ integer
verborgeneIDnutzen 0, 1, Typ integer
baumtiefe ≥ 0, 3, Typ integer
gruppierMethode 1, 2, Typ integer
anzeigename Typ String
wertw Typ String

Aufklappen Erläuterung
Variante des Befehls UI_CUSTOM_POPUP_INFIELD, zur Verwendung mit Array-Parametern; funktioniert jedoch grundsätzlich auch bei Verwendung mit Parametern.
Hier sprechen wir aber ausschließlich über die Verwendung von Array-Parametern.
Bei deren Verwendung gibt es 2 grundsätzlich völlig unterschiedliche Anwendungsfälle und entsprechende Anwendungsmethoden:
- ein 2-dimensionales Array mit der Dimension array[1][2]: Dieser Fall dient der Anzeige bzw. Ausgabe von Gruppe und Textinhalt zusammen oder einzeln.
- ein 2-dimensionales Array mit beliebiger Dimension in beiden Richtungen: Dieser Anwendungsfall ist in der offiziellen Dokumentation nicht aufgeführt. Er wird verwendet, wenn man UI_CUSTOM_POPUP_INFIELD{2} mit Arrayparametern mit größeren Dimensionen als 2 in einer Schleife ausgeben möchte.

Aufklappen Beispiel
Beispiel 1:
In diesem Beispiel haben wir einen Parameter stTextArray[1][2]. In der 1. Spalte des Arrays wird der Gruppenwert angezeigt, in der 2. Spalte der Textwert.
verborgeneIDnutzen und baumtiefe sind beide 0, trotzdem haben wir eine sichtbare Baumtiefe von 1. Der Screenshot zeigt das Popup und die Anzeige.

Code Beispiel 1 
ui_custom_popup_infield{2} "stTextArray", 
200, 100, 120, 19,    ! X Position, Y Position, Breite, Höhe
0,                    ! Verdeckte ID nutzen
0,                    ! Baumtiefe
1,                    ! gruppierMethode
"",                   ! Ausgewählter Wert Beschreibung: gleich wie die ID 
"Group1", "Text1",
"Group1", "Text2",
"Group1", "Text3",
"Group2", "Text1"


Beispiel 2:
Dieses Beispiel zeigt einen einfachen Hierarchiebaum ohne Gruppierungen. Eine baumtiefe von 0 ist hierbei nicht erlaubt (ergibt keine Fehlermeldung, liefert aber auch keinen Popupinhalt. Daher besitzt diese den Wert 1. verborgeneIDnutzen muss ebenfalls 1 sein.
Im internen Array hiddID_value werden die Werte für die hiddenID und die Textanzeige jeweils paarweise gespeichert. hiddenID zeigt die Parameterausgabe und die Textanzeige die Werte im Popup. Hier wurde mit einer Abkürzung und ausgeschriebenen Version gearbeitet.

Code Beispiel 2 
DIM hiddID_value[]
i = 1
hiddID_value[i] = "EF" : hiddID_value[i + 1] = "Einfachfalz"    : i = i + 2
hiddID_value[i] = "DF" : hiddID_value[i + 1] = "Doppelfachfalz" : i = i + 2
hiddID_value[i] = "ST" : hiddID_value[i + 1] = "Stumpf"       : i = i + 2

FOR i = 1 TO 4
   FOR j = 1 TO 2
      if j = 1 THEN
         ui_custom_popup_infield{2} falztyp[i][j], (j - 1 ) * 51, (i - 1) * 25, 50, 20,
         1, 1, 1, "", 
         hiddID_value
      ENDIF
      if j = 2 THEN
         ui_custom_popup_infield{2} falztyp[i][j], (j - 1 ) * 51, (i - 1) * 25, 50, 20,
         1, 1, 1, "", 
         hiddID_value
      ENDIF
   NEXT j
NEXT i


Aufklappen Referenzen
GRAPHISOFT GDL-CENTER reference guide
New Custom Popup Infield von Graphisoft

Aufklappen Kontext
User Interface

Aufklappen ArchiCAD
20