Rich-UI-Widget 'List'

Ein Rich-UI-Widget 'List' definiert eine Liste, aus der der Benutzer einen einzelnen Eintrag auswählen kann.

Das folgende Beispiel zeigt Code, der den Listenwert in einem Textfeld anzeigt:
import com.ibm.egl.rui.widgets.List;
import com.ibm.egl.rui.widgets.TextField;
import egl.ui.rui.Event;

Handler MyHandler Type RUIHandler 
   { initialUI = [myList, myTextField]}

   myList List
   {
      values = ["one", "two", "three", "four"],
      selection = 2, onChange ::= changeFunction
   };

   myTextField TextField
      {text = myList.values[myList.selection]};

   Function changeFunction(e Event in)
      myTextField.text = myList.values[myList.selection];
   end
end 
Die folgenden Eigenschaften werden unterstützt:
  • values: Diese Eigenschaft enthält eine Feldgruppe mit Zeichenfolgen, die jeweils eine auswählbare Option darstellen.
  • selection: Diese Eigenschaft enthält eine Ganzzahl, die die Position der Zeichenfolge in der Feldgruppe darstellt. Wenn Sie den Wert der Eigenschaft selection festlegen, bevor das Listenfeld angezeigt wird, wird die angegebene Zeichenfolge in Fettdruck angezeigt.

    Die erste Zeichenfolge in der Feldgruppe hat die Position 1, nicht die Position 0.

  • size: Diese Eigenschaft enthält einen ganzzahligen Wert, der angibt, wie viele Zeichenfolgen aus der Feldgruppe values angezeigt werden sollen. Die Standardeinstellung ist, dass alle Zeichenfolgen ohne Schiebeleiste angezeigt werden:
    • Wenn der Wert der Eigenschaft size kleiner als die Anzahl der Zeichenfolgen ist, wird nur die angegebene Anzahl von Zeichenfolgen angezeigt. Eine Schiebeleiste ermöglicht den Zugriff auf die anderen Zeichenfolgen.

      Zu Anfang werden nur die letzten Zeichenfolgen angezeigt.

    • Wenn der Wert der Eigenschaft size größer als die Anzahl der Zeichenfolgen ist, werden am unteren Ende des Listenfelds zusätzliche Leerzeichen hinzugefügt. Der Benutzer kann keinen Inhalt aus einem dieser Leerzeichen auswählen, die nur zur Anzeige vorgesehen sind.

    Wenn Sie die Eigenschaft size nicht festlegen, zeigt Internet Explorer 6 das Widget als Kombinationsfeld (Kombination aus Textfeld und Listenfeld) an.

Weitere unterstützte Eigenschaften und Funktionen werden im Abschnitt “Widgeteigenschaften und Widgetfunktionen” beschrieben.

Zur Verwendung dieses Widgets ist die folgende Anweisung erforderlich:
import com.ibm.egl.rui.widgets.List;