# listbox

リストボックスを開き、ユーザーに項目を選択させる。

    listbox <message> <title> <string array>

## パラメータ

文字列 <message>
  リストボックスに表示されるメッセージ。
文字列 <title>
  リストボックスのタイトル。
文字型文字列 <string array>
  リストボックスの選択項目。

## 返り値

システム変数 <result>
  項目が選択された場合、0 - (N-1)のいずれかの値が格納される。
  キャンセルされた場合、-1が格納される。

## 解説

listbox マクロコマンドは <string array> の配列要素をすべて選択項目として表示します。
以下のように、表示しようとする選択項目数より大きい要素数で <string array> を定義すると、最後に空文字列が表示されます。

    strdim msg 4
    msg[0] = 'バナナ'
    msg[1] = 'りんご'
    msg[2] = 'みかん'
    listbox '好きな食べ物を選んでください' 'あなたへの問い' msg

    ; 選択肢が4つ表示される
    バナナ
    りんご
    みかん
    [空文字列]

## 例

    strdim msg 3
    msg[0] = 'バナナ'
    msg[1] = 'りんご'
    msg[2] = 'みかん'
    listbox '好きな食べ物を選んでください' 'あなたへの問い' msg
    sprintf2 var "%d" result
    messagebox var "result"
    ; result
    ;   -1: Cancel
    ;    0: バナナ
    ;    1: りんご
    ;    2: みかん

## 参照

- yesnobox