This standard runtime function displays or “pops up” one of the pulldown menus as an isolated menu, that is, without the menu bar. The popup menu looks and works just like the pulldown menu, including enabled, disabled, and checked options, accelerators, and mnemonics. Commands are chosen in the same way as from the pulldown menu.
The popup menu is modal. You must make a choice or cancel the menu with the pulldown menu Cancel button or by clicking the mouse outside the border of the menu. If a command is not selected, none of the event type conditions reported in RMPANELS.WS is set. The popup menu does not affect the setting of RMP--LAST-FIELD, RMP--NEXT-FIELD, or any of the other event parameters.
RMP--COMMAND-NAME must be set to the name of one of the commands on the pulldown menu for this panel.
RMP--PANEL-LINE can be set as follows:
| Value | Description |
|---|---|
| 0 | Display the pop-up menu on the same line on which it would be displayed if selected from the pulldown menu |
| 999 | Center the pop-up menu vertically on the screen |
Any other value indicates a specific line on which the pop-up menu should be displayed.
RMP--PANEL-POS may be set as follows:
| Value | Description |
|---|---|
| 0 | Display the pop-up menu on the same column on which it would be displayed if selected from the pulldown menu |
| 999 | Center the pop-up menu horizontally on the screen |
Any other value indicates a specific column on which the pop-up menu should be displayed.
| Status value | Description |
|---|---|
| 0 | The function executed successfully. |
| 5 | The panel is not in this library |
| 6 | The library does not exist. |
| 10 | The panel is not displayed. |
| 14 | A COBOL input/output error was encountered on the panel library during execution of this function. To determine the exact nature of the I/O error, use the C$RERR subprogram. |
| 16 | A window error has occurred. |
| 20 | The menu command name is invalid. |
| 22 | There is no pulldown menu on this panel. |