Set.menu.item
The set.menu.item command adds a menu item to a menu.
Syntax
set.menu.item(msg mA, ctl cB);
set.menu.item("menu item text", ctl cB);
Remarks
In AGI menus are the displayed along the top of the menu bar, and each menu may have zero or more menu items, which are the drop-down list of items to choose from.
The set.menu.item command adds new menu item mA to a menu. The menu item is assigned to controller cB. If the player selects the menu item, the appropriate controller evaluation table entry is set to TRUE, which can then be tested by using the controller command.
Menu items are displayed under the menu in the order that they are added with the set.menu.item command. The first entry item determines the width of the entire menu box. If any later menu item entries are longer than the first, the menu window will not draw correctly. You should pad the first menu item entry enough spaces so it is at least as long as all other entries.
Additional information can be found in the Menus in AGI topic.
Possible Errors
Do not include a line break in a menu item; the extra lines will display on the line below the item, and will not automatically erase, unless covered up by another menu selection.
Example
<syntaxhighlight lang="agi"> [ build a simple menu system set.menu("Info"); set.menu.item("About ", c0); set.menu.item("Help ", c1); set.menu("File"); set.menu.item("Save Game <F5>", c2); set.menu.item("Restore Game <F7>", c3); set.menu.item("-------------------", c20); set.menu.item("Restart Game <F9>", c4); set.menu.item("-------------------", c20); set.menu.item("Quit <Alt Z>", c5);
disable.item(c20); [ disable the separators submit.menu(); [ submit menu to agi </syntaxhighlight>
Technical Information
| Required Interpreter Version: | Available in version 2.272 and above. |
| Byte-Code Value: | 157 (0x9D hex) |
