画面表示しているリストの中から選択させるときに使用します。表示するデータ量や選択肢の数が多いときに使用することをお勧めします。例えば，マスタファイル検索結果としての複数のデータの中からデータを選択させる場合などに適しています。表示する範囲が限られていても，スクロールバー^※を付けて定義した表示範囲よりも大きなリスト項目を表示できます。

リストボックスには，表示データから一つのリスト項目だけ選択できる「単一選択リストボックス」と，複数のリスト項目を選択できる「複数選択リストボックス」があります。単一選択リストボックスでリスト項目を選択する場合，フォーカスが位置づいたリスト項目を自動的に選択する方法と，フォーカスに関係なくキー操作やマウス操作などでリスト項目を選択する方法があります。どちらの方法でリスト項目を選択するかは，表示・印刷セットアップで設定します。詳細は，マニュアル「XMAP3 開発・実行ガイド」を参照してください。

リストボックスの表示属性の標準値は文字色が「黒」，「ボックス枠を付ける」，「垂直スクロールバーを付ける」です。リストボックスの表示属性の詳細については，「付録A　属性情報一覧」を参照してください。

注※

フォーカスが位置づいていない状態でリストボックスのスクロールバーをマウスでスクロールしても，リストボックスにフォーカスは移動しません。リストボックスにフォーカスを位置づけたい場合は，［Tab］キーを押すか，リスト項目をマウスでクリックしてください。

＜この項の構成＞

(1)　表示形式

(2)　使用目的

(3)　入出力時のAPインタフェース

(4)　表示属性の動的変更

(5)　リスト項目数の動的変更