RunMenu Verb

The RunMenu verb opens and executes an XML menu file.

Syntax

RunMenu [path\]<filename>[.xml]

The filename parameter specifies the name of the menu file to load and execute.  It is not necessary to specify the .xml extension.  If you do not specify a full path, the verb will look for the menu in the system Menu folder.  The system folder is stored in the System.MenusFolder setting; the default value is ~\Menus\, where ~ is a control code to indicate the root BBS folder.

Frequently Asked Questions

Q. How do I "gosub" and "return" from menus in a stack like manner?

You can implement a simple menu stack by using the RunMenu verb as a menu command.  For example, if an item in your main menu executes the verb "RunMenu File", then the File menu will be displayed.  The BBS will return to the main menu once the file menu is finished.

Q. How do I clear the menu stack?

This is not supported.

Q. I want to allow the user to jump between menus but I do not want to use a stack.  Is there a "GOTO" command?

Yes.  There are three types of menu commands:

A link-type menu item tells the menu system to replace the current menu with the designated menu.  The exit-type menu item causes the current menu to terminate.  The Execute-type menu item is the default type of menu item and is used for executing verb commands.  You should use a link instead of the RunMenu verb if you want to replace the current menu (instead of calling a separate menu and returning later).

See Also