x_choose interactive window choice (modal dialog)

## Syntax

    [num]=x_choose(items,title [,button])

## Arguments

items

  column vector of string, items to choose

title

  column vector of string, comment for the dialog

button

  string, text to appear in the button. Default value is 'Cancel'

num

  integer, chosen item number or 0 if dialog resumed with "Cancel" button

## Description

Returns in `num` the number of the chosen item.

WARNING: this dialog was not modal before Scilab 5.0, please use x_choose_modeless for ascendant compatibility.

## Examples

    n = x_choose(['item1';'item2';'item3'],['that is a comment';'for the dialog'])
    n = x_choose(['item1';'item2';'item3'],['that is a comment'],'Return')

## See also

- x_choose_modeless
- x_choices
- x_mdialog
- getvalue
- unix_g