Popup

POPUP

popup <file>, m=<i>

Function

Call and activate a multiple choice Window based "recursive" popup menu. Recursion means that an option in the menu file can activate a sub-popup menu in a recursive fashion, using appropriate widgets available in the windowing system. The configuration is located in the appropriate .MEN file (see menu file format).

Parameters

file	The name of the file containing the menu. The default extension is MEN. (see note below)
	The format is:
	'title'
	opt, 'text':<commands>
	opt, 'text'><sub-menu file>
	opt, 'sub title'& opt, 'text^Ctrl+X’: <commands>

	If 'opt' is -1 then the option is frozen i.e. it is half-toned and not selectable.

Examples

popup master

popup master,m=144

popup master,m=x11_yellow

Notes

Detailed description of the use of the POPUP menu can be found in the UI Framework documentation.

Only ONE line is accepted for the title; further lines are ignored. If the same popup file (<file>.men) is called recursively, the error/warning message is: File not found <file>.men.

In a popup menu (file .MEN), if the “comment” line (identified by an ending “&”) is null then one separator line is displayed, while if the string is not empty it behaves as in previous versions.

Allow no title in popup menus (environment variable POPUP_IGNORE_TITLE=yes/no).

Left clicking outside a popup menu causes the popup to exit.

Button 1 of the mouse is used to select an option from the menu. If button 1 is pressed outside the menu it is then deselected thereby enabling the user to move the menu using button 2. Sub menus are activated moving the cursor above the options "marked" with an arrow on the right. During the "moving" phase all the exposed widget are available to the selection.

The default popup position is set to the last gin position.

Refer to configuration settings for description of PATCH5468 which resolves interactive use of POPUP > OPTIONS ON > POPUP > OPTIONS ON