Differences

This shows you the differences between two versions of the page.

--- menus [2019/03/24 20:50] – g00r00
+++ menus [2019/03/24 21:24] (current) – [MENU SYSTEM] g00r00
@@ Line 1: / Line 1: @@
 ====== MENU SYSTEM =======
+^ Related Categories                        ^
+| [[themes|Themes]]                         |
+| [[menu_commands|Menu Command Reference]]  |
 -----
@@ Line 68: / Line 72: @@
 === Command List ===
 When a menu is first opened for editing, the default view is the list
 of options defined in the menu.  This view is presented first because
@@ Line 105: / Line 110: @@
 </code>
-  * Insert   - Insert a new command
+  * **Insert**   - Insert a new command
-  * Delete   - Delete the highlighted command
+  * **Delete**   - Delete the highlighted command
-  * Copy     - Copy the highlighted command
+  * **Copy**     - Copy the highlighted command
-  * Paste    - Paste the copied command
+  * **Paste**    - Paste the copied command
-  * View     - View the generated menu.
+  * **View**     - View the generated menu.
-  * Settings - Adjust the settings of the menu
+  * **Settings** - Adjust the settings of the menu
 === Menu settings ===
@@ Line 167: / Line 172: @@
 |Lightbar/Grid|Allows you to define the jumps between menu options based on the user's input.  It is more complicated to set up but allows for more intricate control over how menu input behaves.  The Up, Down, Left, Right, Home, Escape, Tab, PageUp, PageDown, and End fields can link to a command ID found in the menu.  When the user presses one of the keys while the command option is selected, Mystic will jump to the command ID defined for that key.  A series of menu commands can also be defined for each specific key press, and will be executed prior to jumping to the defined command ID.|
-=== Command Editor ===
+=== Option Editor ===
-The Command Editor is used for editing the individual commands.
+The Option Editor is used for editing the individual menu options.
 <code>
 █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Option  #20 (account) ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄
@@ Line 189: / Line 194: @@
 </code>
-  * Display Text - The text that is displayed in the Command List window list.
+  * **Display Text** - The text that is displayed in the Command List window list.
-  * Lightbar Low - The text that is displayed when this lightbar menu option is cold.
-  * Lightbar High- The text that is displayed when this lightbar menu option is hot.
+  * **Lightbar Low** - The text that is displayed when this lightbar menu option is cold (deselected).
-  * Hot Key - The keyboard keys that will activate this command.  There are many automatic
-  * Access - Define the ACS string for this menu.  Use CTRL-L to see a list of non-keyboard keys that can be used.
+  * **Lightbar High** - The text that is displayed when this lightbar menu option is hot (selected).
-  * X,Y - The X,Y location for the Lightbar Low and and Lightbar High text
-  * Timer - Sets the number of seconds to activate the Timer-based execution or 0 to disable a time-based execution of this menu command.
+  * **Hot Key** - The key(s) that the user must enter in otder to activate this command.  When hotkey input is enabled for a menu, keys with multiple characters can be executed by typing a / before it.  When longkey input is enabled for a menu, the / key is not needed.  In other words, if the key is "RUN" then the user would type /RUN on a hotkey menu or just "RUN" on a longkey input menu.  In addition the a typical hotkey, there are some reserved words that can be used here that allow for various auto-execution type of commands or display formatting to be done that are not dependent on user input to execute.  Pressing Control+L will open up a reference of these commands.
-  * Timer Type - Sets the type of time-based execution.  When set to "Interval" then the command will be automatically executed after <Timer> number of seconds.  When set to "OnlyOnce" the command will be automatically executed one time when the menu is loaded after <Timer> number of seconds.  When set to "PerRedraw" then the command will be automatically executed after <Timer> seconds every time the menu is redrawn.
-  * Redraw - If set to TRUE the menu will be redrawn after this menu selection is executed.  If set to false the menu will not be redrawn after execution.
+  * **Access** - Define the ACS string required for this menu option to be executable by the user
-  * Up, Down, Left, Right, Home, Escape, Tab, PageUp, PageDn, End - These are used only by Grid style menus and each one defines which menu command ID to switch to when the user presses the key with this command highlighted.
+  * **X, Y** - The X,Y location for the Lightbar Low and and Lightbar High text
+  * **Timer** - Sets the number of seconds to activate the Timer-based execution or 0 to disable a time-based execution of this menu command.
+  * **Timer Type** - Sets the type of time-based execution.  When set to "Interval" then the command will be automatically executed after <Timer> number of seconds.  When set to "OnlyOnce" the command will be automatically executed one time when the menu is loaded after <Timer> number of seconds.  When set to "PerRedraw" then the command will be automatically executed after <Timer> seconds every time the menu is redrawn.
+  * **Redraw** - If set to TRUE the menu will be redrawn after this menu selection is executed.  If set to false the menu will not be redrawn after execution.
+  * **Up, Down, Left, Right, Home, Escape, Tab, PageUp, PageDn, End** - These are used only by Grid style menus and each one defines which menu command ID to switch to when the user presses the key with this command highlighted.
  This allows very intricate configuration of menu selection behavior at the expense of complexity.
-Each command can perform several sub-tasks in a series.
+Each option can perform several sub-tasks in a series when the option is selected and these tasks are defined by creating a menu command or a list of menu commands within the option.  Select (TAB) to toggle between the option metadata and the list of menu commands for this menu option.
-Select (TAB) to toggle between the command metadata menu and the list of sub-commands for this command.
+=== Menu Command Editor ===
+Many menu commands can be defined to be executed by a single menu option.  The menu commands will be activated in serial order when the menu option is activated.  This allows for multiple actions for one menu command.  Each menu command can have its own access string requirement which allows for advance techniques such as command branching.
-=== Sub Command Editor ===
+A list of menu commands can be found in the [[menu_commands|Menu Command Reference]]
-Many sub commands can be stacked in one menu command.  The sub commands will be activated in serial order when the menu command is activated.  This allows for multiple actions for one menu command.
 <code>
@@ Line 218: / Line 234: @@
 </code>
-  *Command - Select from a picklist of available menu commands.
+  * **Command** - Select from a pick list of available menu commands.  Type to search when window is open.
-  *Data - The optional data field to use for menu commands that require more information.
+  * **Data** - The optional data field to use for menu commands that require more information to execute.
-  *Access - The ACS string to use for this sub command
+  * **Access** - The access string (ACS) that the user must meet in order to execute this menu command.
-  *Execute - Execute the sub command on which grid event.  Used only on Lightbar/Grid menus.
+  * **Execute** - Used only for Grid style menus.  This command defines which hotkey the user must have pressed for this menu command to execute.
 -----