| Maptitude GISDK Help |
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
<statements go here>
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 format alt_character, where character must be a letter or number. For example, Key: alt_A indicates 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 the List array. |
|
Variable: variable |
Indicates the user's selection. If Editable is not specified, the variable is an index into the List array. If Editable is 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
| ©2025 Caliper Corporation | www.caliper.com |