Groovy Bytes: Behind the Moon/groovybytes.iso/GROOVY/SND_TOOL/WM10.ZIP/DOC.DAT/menucmnd.txt

Text File | 1995-08-30 | 5.8 KB | 138 lines

 WAVmaker Menu Commands
 ──────────────────────

 This document describes features common to WMmain and WMmenu. For differences,
 see {WMmenu}.

 Contents:   ■ Selecting a menu entry   {MenuCmnd  13}
 ─────────   ■ What can else I do?      {MenuCmnd  30}
             ■ Function key operations  {MenuCmnd  53}
             ■ The command line         {MenuCmnd 103}


─── Selecting a menu entry ─────────────────────────────────────────────────────

 While in WMmain/WMmenu, there is always a currently selected menu entry (shown
 in white on blue background). The selection is changed by either

                  (1) Sliding the mouse vertically, or

                  (2) Using the keypad:

                      ■ Up arrow key to move up one entry
                      ■ Down arrow key to move down one entry
                      ■ PgUp key for the first entry
                      ■ PgDn key for the last entry

 There can be up to 22 menu entries. The last one is always the Exit command.


─── What else can I do? ────────────────────────────────────────────────────────

 Apart from selecting entries (and terminating the menu program), you can

                  (1) Get Help for the currently selected entry
                      (press Alt-H).

                  (2) Call up a Function key window displaying
                      Function key titles and values (press Alt
                      and a Function key between F1 and F10).

                      See {MenuCmnd 53}.

                  (3) Edit the command line.

                      See {MenuCmnd 103}.

                  (4) Execute the command line (click the Left
                      mouse button or hit Enter).

 For details about what goes on behind the scene in each case, see {Customiz}.


─── Function keys ──────────────────────────────────────────────────────────────

 While in WMmain and WMmenu, you have ten programmable Function keys (F1 to
 F10) at your disposal. Each one is assigned a title and a value. Titles and
 values can be up to 15 characters long (reflecting the size of the default
 DOS keyboard buffer).

 At startup, the Function key titles are read from the menu definition file.
 Thereafter, a private Function key file is read. There is one such file for
 each menu {Customiz}. It's used to store Function key values between runs.
 Finally, WMmenu will read the public file used by all WAVmaker applications
 to exchange Function key information {FnKeys}, so as to inherit new values
 for Function keys with titles matching those in the public file. This way,
 new Function key values can be propagated down from a menu to a submenu
 (WMmain does not inherit Function key values at startup, since it's supposed
 to manage the top level menu ONLY).

 To call up a window showing all current Function key titles and values, press
 Alt and a Function key between F1 and F10 (this works in all WAVmaker
 applications with Function key support, by the way).

 To make the Function key window go away, either

                        ■ Press Alt and F1-F10 again, or
                        ■ Hit the Esc key, or
                        ■ Click the Right mouse button, or
                        ■ Select a new menu entry

 Hitting a Function key without the Alt modifier causes the current value of
 the Function key to be written to the command line.

 There is no mechanism for ASSIGNING values to Function keys in WMmain and
 WMmenu. This is done in the applications called from the menu.

 An example:
 ───────────

 In WAVmaker, WM Read is used to browse directory listings {ReadDir}. While
 doing this, you can select a filename and assign it to the Function key
 entitled "File #1". Upon return to the calling menu, hitting the Function key
 entitled "File #1" (provided that the menu in question has one) will cause
 the filename to be written to the command line, avoiding you the hassle of
 having to remember it (and of having to type it in correctly!) when entering
 the next command.

 Also, many WAVmaker applications will automatically write various parameters
 (filenames, times, sample numbers etc.) to the public Function key file,
 making them available to the calling program.


─── The Command line ───────────────────────────────────────────────────────────

 Reading from left to right, the command line contains the following
 components:

                 (1) The current directory (in black). Each menu entry
                     has itw own "home" directory, so don't be surprised
                     to see this component change with your menu selection.

                 (2) The command associated with the selected menu entry,
                     if there is one (in white).

                 (3) The default parameters for the selected menu entry,
                     if there are any (in black).

 The difference between commands (2) and default parameters (3) is that the
 former are write protected, while the latter can be edited. The command line
 edit commands are the usual ones:

                  ■ Ins key (toggle Insert/Overwrite mode)
                  ■ Del key (delete next character)
                  ■ Backspace (delete previous character)
                  ■ Left arrow (move cursor one character left)
                  ■ Right arrow (move cursor one character right)
                  ■ Home key (move cursor to the first editable character)
                  ■ End key (move cursor to the last non-blank, editable
                    character)

 Hitting Function keys F1 to F10 causes the current value of the Function key
 to be written to the command line {MenuCmnd 53}.

 In order to execute the current command line,

                        ■ Hit Enter, or
                        ■ Click the Left mouse button