**CIGAL Reference Manual, Chapter 2 (Commands): MENU** ===== MENU -- Load, activate, or inactivate command menus ===== **usage: menu [flag] name [ name2 ... ] [dflg] ; load/unload the named menu(s)**\\ **or: menu [flag] [name] [dflg] {...}; load an explicit menu**\\ **or: menu 0 [mnutype]; inactivate menu**\\ **or: menu -1 [mnutype]; restore previous menu**\\ **or: menu ; redraw menu display**\\ The MENU command is used to read, activate, or inactivate command menus. The 5 different types of menus (PULL-DOWN, FUNCTION, SCREEN, TABLET and TEMPSCREEN) are all controlled by this command (see [[jvs:cigal:manual:chapter1:menus|MENUS(1)]] for more general information on the different types of CIGAL menus). The FLAG argument controls the meaning of the MENU command: 1-10 Read/Activate menu as Pull-down menu (1-10 is position on menu bar) 11 Read/Activate menu as Function menu 12 Read/Activate menu as Screen menu 13 Read/Activate menu as Tablet menu 14 Read/Activate menu as TempScreen menu 0 Inactivate menu (next argument can specify which menu) -1 Restore previous menu (next argument can specify which menu) Note: When reading or activating a Function, Screen, or Tablet menu the format of the menu is sufficient to indicate which type, so the FLAG argument is generally not necessary. For a Pull-down menu you only need the FLAG if you want to specify in which position to put the menu, otherwise it will appear in the first available menu bar position. For a TempScreen menu you must specify the flag. __**Reading a Menu**__ If a named menu is not found in CIGAL's system menu library, then the MENU command will first attempt to read the menu into the library. See [[jvs:cigal:manual:chapter1:makemenu|MAKEMENU(1)]] for information on how to create new command menus. The DFLG argument can be included to specify menu display options. The following flags can be combined by addition: 1 SAVMODE save current video display mode with mode; when the menu is activated in any other video mode it will automatically switch back to its saved mode 2 SAVSCR store current video screen display as menu display 4 STORTXT store display as processed video text 10o TEMP delete menu from system table when inactivated (default for '{' if no name specified) 20o STDIN read menu from standard input (default for '{') Note: the NAME argument is not needed if the menu is temporary, loaded explicitly, and not a Pull-down menu. __**Inactivating a Menu**__ At any one time you can have 1 Function menu, 1 Screen or Tablet menu, and up to 10 Pull-down menus active. You inactivate a menu by entering: menu 0 name or menu 0 mnu or menu 0 mnu1 mnu2 mnu3 ... or menu 0 mnufirst - mnulast For all but the first of these, the menus to inactivate are specified by menu position number, as described for the FLAG argument above. If no menu is specified, the current Screen or Tablet menu is inactivated. MNUFIRST to MNULAST can be used to inactivate many consecutive menu numbers. Examples: menu 0 ; turn off the screen menu (or tablet) menu 0 1 - 10 ; inactivate all pull-down menus __**Reactivating menus**__ Pull-down or function menus that have been inactivated, can be reactivated by entering the command: menu - mnu1 mnu2 ... or menu - mnufirst - mnulast Examples: menu - 11 ; reactivate the function key menu menu - 1 - 10 ; reactivate all pull-down menus __**Restoring Previous Menu**__ __**Redrawing the Menu Display**__ If at any time the menu display disappears, you can redraw it with: menu **See Also:**\\ [[jvs:cigal:manual:chapter2:delete|DELETE(2)]], [[jvs:cigal:manual:chapter2:dir|DIR(2)]], [[jvs:cigal:manual:chapter2:edit|EDIT(2)]], [[jvs:cigal:manual:chapter1:makemenu|MAKEMENU(1)]], [[jvs:cigal:manual:chapter1:menus|MENUS(1)]], [[jvs:cigal:manual:chapter2:show|SHOW(2)]], [[jvs:cigal:manual:chapter1:tablets|TABLETS(1)]], [[jvs:cigal:manual:chapter1:windows|WINDOWS(1)]] [[jvs:cigal|CIGAL Home]], [[jvs:cigal:manual|CIGAL Manual]], [[jvs:cigal:manual:chapter2|Commands List]], [[jvs:cigal:manual:help|Manual Help]]