menu
(Not recommended) Create multiple-choice dialog box
Note
Themenu
function is not recommended. Use thelistdlg
function instead.
Description
choice = menu(message,opt1,opt2,...,optn)
displays a modal menu dialog box containing the text inmessage
and the choices specified byopt1
,opt2
,...optn
. Themenu
function returns the number of the selected menu item, or 0 if the user clicks the close button on the window. Specifymessage
as a character vector or string scalar. Specifyopt1
,opt2
,...optn
as character vectors or string scalars.
choice = menu(message,options)
specifies the choices as a cell array of character vectors or string array.
If the user's terminal provides a graphics capability,menu
displays the menu items as push buttons in a figure window (Example 1). Otherwise. they will be given as a numbered list in the Command Window (Example 2).
Examples
Example 1
On a system with a display,menu
displays choices as buttons in a dialog box:
choice = menu('Choose a color','Red','Blue','Green')
The number entered by the user in response to the prompt is returned aschoice
(i.e.,choice = 2
implies that the user selectedBlue
).
After input is accepted, the dialog box closes, returning the output inchoice
. You can usechoice
to control the color of a graph:
t = 0:.1:60; s = sin(t); color = ['r','b','g'] plot(t,s,color(choice))
Example 2
On a system without a display,menu
displays choices in the Command Window:
choice = menu('Choose a color','Red','Blue','Green')
displays the following text.
----- Choose a color ----- 1) Red 2) Blue 3) Green Select a menu number:
Tips
To callmenu
from within a callback of aUIControl
or other UI component, set that object'sInterruptible
property to'on'
. For more information, seeUIControl Properties.