This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

menu

(Not recommended) Create multiple-choice dialog box

Note

The menu function is not recommended. Use the listdlg function instead.

Syntax

choice = menu(message,opt1,opt2,...,optn)
choice = menu(message,options)

Description

choice = menu(message,opt1,opt2,...,optn) displays a modal menu dialog box containing the text in message and the choices specified by opt1, opt2,... optn. The menu function returns the number of the selected menu item, or 0 if the user clicks the close button on the window. Specify message as a character vector or string scalar. Specify opt1, 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')
displays the following dialog box.

The number entered by the user in response to the prompt is returned as choice (i.e., choice = 2 implies that the user selected Blue).

After input is accepted, the dialog box closes, returning the output in choice. You can use choice 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 call menu from within a callback of a UIControl or other UI component, set that object's Interruptible property to 'on'. For more information, see UIControl Properties.

Introduced before R2006a