CONNECT MENU
FUNCTION
This command enables you to connect to a menu definition specified in Dictionary-IV and display the menu during script execution.
SYNTAX
CONNECT MENU menu-name$- menu-name$
- the name of a menu definition specified in Dictionary-IV.
NOTES
- This command enables you to connect to a pop-up menu from a script and to connect to other pop-up menus from menus invoked by the CONNECT MENU command.
- After the menu completes, execution resumes with the following Script-IV command.
- Menu processing is controlled by the values specified in the MENU$[ALL] string array. If the array does not exist, Script-IV will automatically build the array. If the array exists, Script-IV will use the values in the array to control processing.
- The MENU$[ALL] string array is described below:
| MENU$[ALL] | Passed to menu class from a script’s CONNECT MENU command. | |
|---|---|---|
| [0] | Menu function (FUNC$), which is described below. | |
| [1] | Menu name: | |
| [1,n] | Used to pass messages between user-developed methods. | |
| [2] | Selection from menu. On input, used to set the default selection. On output, used to return the selected item. Refer to FUNC$(15,1). |
• The FUNC$ (from MENU$[0]) string array is described below:
| FUNC$ from MENU$[0] | 1,1 = | “C” | Clear the menu window and reselect the window prior to menu display. |
|---|---|---|---|
| “D” | Leave menu window displayed and reselect the window prior to displaying the menu using the NOUPDATE option. This is an efficient option, but you must use it carefully. | ||
| “X” | Leave the menu window displayed and selected after exit. | ||
| “x” | Display the menu but do not allow the user to make a selection. Leave the menu window displayed and selected after exit. | ||
| 2,1 = | “ “ | No heading. | |
| “C” | Centered heading | ||
| “L” | Left-justified heading. | ||
| “R” | Right-justified heading. | ||
| Note: The menu description is the displayed heading. | |||
| 3,1 = | “ “ | F10 Home enabled. | |
| “X” | F10 Home disabled. Perform defined F10 key function. | ||
| 4,1 = | “ “ | When the F6 key is pressed but no help is defined do help for help text. | |
| “X” | When the F6 key is pressed but no help is defined do help for help index. | ||
| 5,1 = | “ “ | F7 special functions enabled. | |
| “X” | F7 special functions disabled. | ||
| 6,1 = | “ “ | If the menu exists, assign a unique name and create a new window. | |
| “X” | If the menu exists, use it. | ||
| 7,1 = | “ “ | Preview of sub-menus enabled. | |
| “X” | Preview of sub-menus disabled. | ||
| 8,1 = | “ “ | Save changes to tab line. | |
| “X” | Do not save changes to tab line. | ||
| 9,1 = | For Script-IV internal use only. | ||
| 10,1 = | “ “ | No substitution. | |
| “1” | Substitute all four bytes of window create parameters: | ||
| 1 | starting column of window | ||
| 2 | starting row of window | ||
| 3 | number of columns per row | ||
| 4 | number of rows per window | ||
| “2” | Substitute only the starting column and row. | ||
| “3” | Substitute only the number of columns and rows. | ||
| 11,1 = | Substitute value for starting column of window. One-byte binary value (ASC). | ||
| 12,1 = | Substitute value for starting row of window. One-byte binary value (ASC). | ||
| 13,1 = | Substitute value for number of columns per row. One-byte binary value (ASC). | ||
| 14,1 = | Substitute value for number of rows per window. One-byte binary value (ASC). | ||
| 15,1 = | “X” | Use the current entry in MENU$[2] as the default selection for the menu. |
EXAMPLES
CONNECT MENU "4SWMENU"SEE ALSO
CONNECT HELP, CONNECT QUERY, CONNECT REPORT, CONNECT SCREEN, CONNECT VIEW. For more information on how to edit and maintain pop-up menus see information on windowed help in the Dictionary-IV Developer Guide.
From the Script-IV Language Reference, version 8.9.1. Open this page in the PDF