Die Eigenschaft
selectedIndexItem gilt für ein VGUIRecord-Feld, das eine Feldgruppe enthält. Der Wert der Eigenschaft ist der Name eines
ausgewählten Indexelements, das ein anderes VGUIRecord-Feld ist, dessen Wert zwei Aspekte der Laufzeitverarbeitung angibt:
- Ob ein Steuerelement (z. B. ein Kontrollkästchen) vorausgewählt ist, wenn die Webseite angezeigt wird
- Ob der Benutzer ein Steuerelement ausgewählt hat
Das Feld, auf das die Eigenschaft verweist, muss vom Typ NUM sein und darf keine Dezimalstellen aufweisen, kann aber in einer Feldgruppe enthalten sein.
Betrachten Sie den folgenden Fall:
- Ein VGUI-Datensatzfeld ist eine Feldgruppe und hat eine Eigenschaft selectedIndexItem, die auf ein Feld (das ausgewählte Indexelement) verweist, bei dem es sich nicht um eine Feldgruppe handelt.
- Die Eigenschaft uiType lautet input oder inputOutput.
In diesem Fall enthält die generierte Webseite Optionsfelder, in denen der Benutzer nur einen Wert auswählen kann. Das ausgewählte Indexelement gibt das Optionsfeld nach Nummer an, wobei die Nummer 1 auf das erste Optionsfeld verweist.
Wenn das ausgewählte Indexelement eine Feldgruppe in demselben Fall ist, enthält die generierte Webseite eine Gruppe von Kontrollkästchen und das Folgende trifft zu:
- Wenn Daten für die Anzeige vorbereitet werden, enthält die Feldgruppe die Indizes der Einträge, die als vorausgewählt festgelegt werden.
- Wenn Daten zurückgegeben werden, enthält die Feldgruppe die Indizes der Einträge, die der Benutzer ausgewählt hat. Wenn der Benutzer beispielsweise Einträge mit den Indizes 1, 3 und 5 ausgewählt hat und das erste Element der Feldgruppe '1' enthält, enthält das zweite Element '3', das dritte Element enthält '5' und der Rest enthält '0'.
Die generierte HTML weicht ab, wenn die Eigenschaft
uiType den Wert
output aufweist:
- Wenn das ausgewählte Indexelement keine Feldgruppe ist, enthält die generierte Webseite ein Paar Strukturen - das Label, das in Fettdruck angezeigt wird, und eine HTML-Struktur <AUSWÄHLEN> (angezeigt als Dropdown-Liste), in der der Benutzer einen Wert auswählen kann.
Wenn das ausgewählte Indexelement z. B. einen Wert von '2' hat, ist der zweite Eintrag vorausgewählt.
- Wenn das ausgewählte Indexelement eine Feldgruppe ist, enthält die generierte Webseite ein ähnliches Paar Strukturen, aber der Benutzer kann mehrere Werte auswählen.
Wenn der Wert des ersten Elements in dem ausgewählten Indexelement '1' und der Wert des zweiten Elements '3' ist, zeigt der Browser eine Dropdown-Liste an und der erste und dritte Eintrag sind vorausgewählt.