Rich-UI-Widget 'Combo'
Ein Rich-UI-Widget 'Combo' definiert ein Kombinationsfeld (Combobox), das eine von mehreren auswählbaren Optionen darstellt und dem Benutzer die Möglichkeit gibt, eine Dropdown-Liste zur Auswahl einer anderen Option zu öffnen.
Das folgende Beispiel zeigt einen entsprechenden Code:
import com.ibm.egl.rui.widgets.Box;
import com.ibm.egl.rui.widgets.Combo;
import com.ibm.egl.rui.widgets.TextField;
import egl.ui.rui.Event;
Handler ListExample Type RUIHandler
{ initialUI = [myBox] }
myBox Box{columns=2, children= [myCombo, myTextField]};
myCombo Combo
{
values = ["one", "two", "three", "four"],
selection = 2, onChange ::= changeFunction
};
myTextField TextField
{text = myCombo.values[myCombo.selection]};
Function changeFunction(e Event IN)
myTextField.text = myCombo.values[myCombo.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: Dies ist ein ganzzahliger Wert, der die Position der Zeichenfolge
in der Feldgruppe darstellt. Wenn Sie den Wert der Eigenschaft selection festlegen,
bevor das Kombinationsfeld angezeigt wird, wird die referenzierte Zeichenfolge zu Anfang angezeigt.
Andernfalls wird die erste Zeichenfolge zuerst angezeigt.
Die erste Zeichenfolge in der Feldgruppe hat die Position 1, nicht die Position 0.
Die folgenden Funktionen sind zur allgemeinen Verwendung vorgesehen:
- getValues: Diese Funktion akzeptiert keine Parameter und gibt eine Feldgruppe von Zeichenfolgen zurück, die jeweils eine auswählbare Option darstellen.
- setValues: Diese Funktion akzeptiert eine Feldgruppe von Zeichenfolgen, die jeweils eine auswählbare Option darstellen. Die Funktion gibt keinen Wert zurück.
Die Funktionen getSelection und setSelection sind verfügbar. Meist ist es jedoch günstiger, einen Wert abzurufen oder einen Wert der Eigenschaft selection zuzuordnen, als eine Funktion aufzurufen.
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.Combo;