Rich UI List

Rich UI list ウィジェットで、ユーザーが単一項目を選択できるリストを定義します。

以下にコードの例を示します。このコード例では、テキスト・フィールドにリスト値が表示されます。
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 
以下のプロパティーをサポートします。
  • values。それぞれが選択可能オプションを表す、文字列の配列を保持します。
  • selection。配列内の文字列の位置を表す整数を保持します。リスト・ボックスを表示する前に selection の値を設定すると、指定された文字列が太字体で表示されます。

    配列内の先頭の文字列は、位置 0 でなく、位置 1 にあります。

  • sizevalues 配列から表示する文字列の数を示す整数を保持します。デフォルトでは、スクロール・バーなしですべての文字列が表示されます。
    • size の値が文字列の数より小さい場合は、 指定した数の文字列のみが表示されます。 スクロール・バーによって他の文字列にアクセスできます。

      最初は、 最終の文字列のみが表示されます。

    • size の値が、文字列の数より大きい場合は、 リスト・ボックスの下部に、追加のスペースが追加されます。 ユーザーがそれらのスペースのいずれかからコンテンツを選択することはできません。これらのスペースは、表示専用です。

    size プロパティーを設定しないと、Internet Explorer 6 では、ウィジェットがコンボ・ボックス (テキスト・ボックスとリスト・ボックスの組み合わせ) として表示されます。

サポートされる他のプロパティーおよび関数は、『ウィジェットのプロパティーと関数』で説明されています。

このウィジェットを使用するには、次のステートメントが必要です。
import com.ibm.egl.rui.widgets.List;