Popdown Menus

A popdown menu, also called a drop-down list in Windows, is like a menu that you can put anywhere in a dialog box. The format of a popdown menu item definition is:

Popdown Menu {"item name"} hpos, vpos {, width {, height}} {options} {do

endItem}

If the do ... endItem section of the popdown menu definition is included, the statements are executed whenever the user changes the selection in the popdown menu. The height specifies the height of the menu when the user has clicked on the popdown menu. If the width is not specified, the menu is twenty characters wide. If the height is not specified, the height of the menu is the smaller of 17 lines or the number of items in the menu.

Popdown Menu Options	Description
Key:hotkey	The key sequence the user can press to move the cursor to the popdown menu instead of using the mouse. The hotkey has the formatalt_character, where character must be a letter or number. For example,Key: alt_Aindicates that holding the Alt key and pressing A activates the item. The specified key is underlined in the item's text. A hotkey only works if the key in question is part of the item's text and is case insensitive.
Disabled	The popdown menu is initially disabled.
Hidden	The popdown menu is initially hidden.
Help:help_specs	Help information displayed in a popup window and the status bar. Help strings can be string expressions.
Prompt:expression	The text that appears to the left of the popdown menu. If omitted, there is no text next to the popdown menu.
List:array	An array of items displayed in the popdown menu. The array can contain strings, integers, real numbers, and sample objects, or can be a formatting array, as described above for Scroll List items.
Editable	Indicates that the user can enter a value into the popdown menu that is not one of the choices in theListarray.
Variable:variable	Indicates the user's selection. IfEditableis not specified, the variable is an index into theListarray. IfEditableis specified, the variable is a string containing the value the user entered or chose from the list.

For example:

Popdown Menu "Sets" 0, 0, 24, 8 prompt: "Selection: " key: alt_s list: set_list variable: set_idx do

chosen_set = set_list[set_idx]

endItem