Rich-UI-Widget 'ListMulti'

Das Rich-UI-Widget 'ListMulti' definiert eine Liste, aus der der Benutzer mehrere Einträge auswählen kann. 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 Feldgruppe mit ganzzahligen Werten, die die Position der Zeichenfolgen in der Feldgruppe values darstellen. Wenn Sie den Wert der Eigenschaft selection festlegen, bevor das Listenfeld angezeigt wird, werden die angegebenen Zeichenfolgen 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.ListMulti;