PageRenderTime 29ms CodeModel.GetById 16ms RepoModel.GetById 0ms app.codeStats 0ms

/AutoHotkey.docset/Contents/Resources/Documents/commands/Menu.htm

https://gitlab.com/ahkscript/Autohotkey.docset
HTML | 256 lines | 227 code | 29 blank | 0 comment | 0 complexity | fb928a847b6399cea45270c04c1c909c MD5 | raw file
    

  1. <!DOCTYPE HTML>
    2. 

  2. <html>
    3. 

  3. <head>
    4. 

  4. <title>Menu</title>
    5. 

  5. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    6. 

  6. <meta http-equiv="X-UA-Compatible" content="IE=edge">
    7. 

  7. <link href="../static/theme.css" rel="stylesheet" type="text/css" />
    8. 

  8. <script src="../static/content.js" type="text/javascript"></script>
    9. 

  9. </head>
    10. 

  10. <body>
    11. 

  11. 

  12. <h1>Menu</h1>
    13. 

  13. 

  14. <p>Creates, deletes, modifies and displays menus and menu items. Changes the tray icon and its tooltip. Controls whether the main window of a <a href="../Scripts.htm#ahk2exe">compiled script</a> can be opened.</p>
    15. 

  15. 

  16. <pre class="Syntax">Menu, MenuName, Cmd [, P3, P4, P5]</pre>
    17. 

  17. <h3>Parameters</h3>
    18. 

  18. <dl>
    19. 

  19. 

  20.   <dt>MenuName</dt>
    21. 

  21.   <dd><p>It can be TRAY or the name of any custom menu. A custom menu is automatically created the first time its name is used with the <em>Add</em> command. For example: <code>Menu, MyMenu, Add, Item1</code>.</p>
    22. 

  22.       <p>Once created, a custom menu can be displayed with the <em>Show</em> command. It can also be attached as a submenu to one or more other menus via the <em>Add</em> command.</p></dd>
    23. 

  23. 

  24.   <dt>Cmd, P3, P4, P5</dt>
    25. 

  25.   <dd><p>These 4 parameters are dependent on each other. See list below for the allowed combinations.</p></dd>
    26. 

  26.   
    27. 

  27.   <dt>MenuItemName</dt>
    28. 

  28.   <dd>
    29. 

  29.     <p>The name or position of a menu item. Some common rules apply to this parameter across all sub-commands which use it:</p>
    30. 

  30.     <p>To underline one of the letters in a menu item's name, precede that letter with an ampersand (&amp;). When the menu is displayed, such an item can be selected by pressing the corresponding key on the keyboard. To display a literal ampersand, specify two consecutive ampersands as in this example: <code>Save &amp;&amp; Exit</code></p>
    31. 

  31.     <p>When referring to an existing menu or menu item, the name is not case sensitive but any ampersands must be included. For example: <code>&amp;Open</code></p>
    32. 

  32.     <p><span class="ver">[v1.1.23+]:</span> To identify an existing item by its position in the menu, write the item's position followed by an ampersand. For example, <code>1&amp;</code> indicates the first item.</p>
    33. 

  33.   </dd>
    34. 

  34. 

  35. </dl>
    36. 

  36. 

  37. <h2>Add or Change Items in a Menu</h2>
    38. 

  38. <p><strong>Add [, MenuItemName, Label-or-Submenu, Options]</strong>: This is a multipurpose command that adds a menu item, updates one with a new submenu or label, or converts one from a normal item into a submenu (or vice versa). If <em>MenuItemName</em> does not yet exist, it will be added to the menu. Otherwise, <em>MenuItemName</em> is updated with the newly specified <em>Label-or-Submenu</em>.</p>
    39. 

  39. <p>To add a menu separator line, omit all three parameters.</p>
    40. 

  40. <p>The label subroutine is run as a new <a href="../misc/Threads.htm">thread</a> when the user selects the menu item (similar to <a href="Gosub.htm">Gosub</a> and <a href="../Hotkeys.htm">hotkey subroutines</a>). If <em>Label-or-Submenu</em> is omitted, <em>MenuItemName</em> will be used as both the label and the menu item's name.</p>
    41. 

  41. <p id="Functor"><span class="ver">[v1.1.20+]:</span> If it is not the name of an existing label, <em>Label-or-Submenu</em> can be the name of a function, or a single variable reference containing a <a href="../objects/Functor.htm">function object</a>. For example, <code>%funcobj%</code> or <code>% funcobj</code>. Other expressions which return objects are currently unsupported. The function can optionally define parameters as shown below:</p>
    42. 

  42. <pre class="Syntax"><i>FunctionName</i>(ItemName, ItemPos, MenuName)</pre>
    43. 

  43. <p>To have <em>MenuItemName</em> become a submenu -- which is a menu item that opens a new menu when selected -- specify for <em>Label-or-Submenu</em> a colon followed by the <em>MenuName</em> of an existing custom menu. For example:</p>
    44. 

  44. <pre>Menu, MySubmenu, add, Item1
    45. 

  45. Menu, tray, add, This Menu Item Is A Submenu, :MySubmenu</pre>
    46. 

  46. <p>If not omitted, <em>Options</em> must be a space- or tab-delimited list of one or more of the following options:</p>
    47. 

  47. <table class="info">
    48. 

  48.   <tr><td>P<em>n</em></td>
    49. 

  49.   <td>Replace <em>n</em> with the menu item's <a href="../misc/Threads.htm">thread priority</a>, e.g. <code>P1</code>. If this option is omitted when adding a menu item, the priority will be 0, which is the standard default. If omitted when updating a menu item, the item's priority will not be changed. Use a decimal (not hexadecimal) number as the priority.</td></tr>
    50. 

  50.   <tr><td>+Radio</td>
    51. 

  51.   <td><span class="ver">[v1.1.23+]:</span> If the item is checked, a bullet point is used instead of a check mark.</td></tr>
    52. 

  52.   <tr><td>+Right</td>
    53. 

  53.   <td><span class="ver">[v1.1.23+]:</span> The item is right-justified within the menu bar. This only applies to <a href="Gui.htm#Menu">menu bars</a>, not popup menus or submenus.</td></tr>
    54. 

  54.   <tr><td>+Break</td>
    55. 

  55.   <td><span class="ver">[v1.1.23+]:</span> The item begins a new column in a popup menu.</td></tr>
    56. 

  56.   <tr><td>+BarBreak</td>
    57. 

  57.   <td><span class="ver">[v1.1.23+]:</span> As above, but with a dividing line between columns.</td></tr>
    58. 

  58. </table>
    59. 

  59. <p>The plus sign (+) is optional and can be replaced with minus (-) to remove the option, as in <code>-Radio</code>. Options are not case sensitive.</p>
    60. 

  60. <p>To change an existing item's options without affecting its label or submenu, simply omit the <em>Label-or-Submenu</em> parameter.</p>
    61. 

  61. <p id="Insert"><strong>Insert [, ItemToInsertBefore, NewItemName, Label-or-Submenu, Options]</strong> <span class="ver">[v1.1.23+]</span>: Inserts a new item before the specified item. Usage is identical to <em>Add</em> (above), except for the additional <em>ItemToInsertBefore</em> parameter, which is the name of an existing item or a position&amp; between 1 and <a href="MenuGetHandle.htm#Examples">the current number of items</a> plus 1. Items can also be appended by omitting <em>ItemToInsertBefore</em> (by writing two consecutive commas). Unlike <em>Add</em>, <em>Insert</em> creates a new item even if <em>NewItemName</em> matches the name of an existing item.
    62. 

  62. <p id="Delete"><strong>Delete [, MenuItemName]</strong>: Deletes <em>MenuItemName</em> from the menu. Standard menu items such as Exit (see below) cannot be individually deleted. If the <em>default</em> menu item is deleted, the effect will be similar to having used the <em>NoDefault</em> option. If <em>MenuItemName</em> is omitted, the entire <em>MenuName</em> menu will be deleted as will any menu items in other menus that use <em>MenuName</em> as a submenu. Deleting a menu also causes the current <a href="#Win32_Menus">Win32 menu</a> of its parent and submenus to be destroyed, to be recreated later as needed.</p>
    63. 

  63. <p id="DeleteAll"><strong>DeleteAll</strong>: Deletes all custom menu items from the menu, leaving the menu empty unless it contains the <em>standard</em> items (see below). Unlike a menu entirely deleted by the <em>Delete</em> command (see above), an empty menu still exists and thus any other menus that use it as a submenu will retain those submenus. However, the current <a href="#Win32_Menus">Win32 menus</a> of this menu and its parent and submenus are destroyed, to be recreated later as needed.</p>
    64. 

  64. <p><strong>Rename, MenuItemName [, NewName]</strong>: Renames <em>MenuItemName</em> to <em>NewName</em> (if <em>NewName</em> is blank, <em>MenuItemName</em> will be converted into a separator line). The menu item's current target label or submenu is unchanged. <span class="ver">[v1.1.23+]:</span> A separator line can be converted to a normal item by specifying the position&amp; of the separator and a non-blank <em>NewName</em>, and then using the <em>Add</em> command to give the item a label or submenu.</p>
    65. 

  65. <p><strong>Check, MenuItemName</strong>: Adds a visible checkmark in the menu next to <em>MenuItemName</em> (if there isn't one already).</p>
    66. 

  66. <p><strong>Uncheck, MenuItemName</strong>: Removes the checkmark (if there is one) from <em>MenuItemName</em>.</p>
    67. 

  67. <p><strong>ToggleCheck, MenuItemName</strong>: Adds a checkmark if there wasn't one; otherwise, removes it.</p>
    68. 

  68. <p><strong>Enable, MenuItemName</strong>: Allows the user to once again select <em>MenuItemName</em> if was previously disabled (grayed).</p>
    69. 

  69. <p><strong>Disable, MenuItemName</strong>: Changes <em>MenuItemName</em> to a gray color to indicate that the user cannot select it.</p>
    70. 

  70. <p><strong>ToggleEnable, MenuItemName</strong>: Disables <em>MenuItemName</em> if it was previously enabled; otherwise, enables it.</p>
    71. 

  71. <p><strong>Default [, MenuItemName]</strong>: Changes the menu's default item to be <em>MenuItemName</em> and makes that item's font bold (setting a default item in menus other than TRAY is currently purely cosmetic). When the user double-clicks the tray icon, its default menu item is launched. If there is no default, double-clicking has no effect. If <em>MenuItemName</em> is omitted, the effect is the same as having used <em>NoDefault</em> below.</p>
    72. 

  72. <p><strong>NoDefault</strong>: For the tray menu: Changes the menu back to having its standard default menu item, which is OPEN for non-compiled scripts and none for <a href="../Scripts.htm#ahk2exe">compiled scripts</a> (except when the <em>MainWindow</em> option is in effect). If the OPEN menu item does not exist due to a previous use of the NoStandard command below, there will be no default and thus double-clicking the tray icon will have no effect. For menus other than TRAY: Any existing default item is returned to a non-bold font.</p>
    73. 

  73. <p><strong>Standard</strong>: Inserts the standard menu items at the bottom of the menu (if they are not already present). This command can be used with the tray menu or any other menu.</p>
    74. 

  74. <p><strong>NoStandard</strong>: Removes all standard (non-custom) menu items from the tray menu (if they are present).</p>
    75. 

  75. <h2 id="MenuIcon">Set or Remove a Menu Item's Icon <span class="ver">[AHK_L 17+]</span></h2>
    76. 

  76. <p><strong>Icon, MenuItemName, FileName [, IconNumber, IconWidth]</strong>: Sets <em>MenuItemName</em>'s icon. <em>FileName</em> can either be an icon file or any image in a format supported by AutoHotkey. To use an icon group other than the first one in the file, specify its number for <em>IconNumber</em> (if omitted, it defaults to 1). If <em>IconNumber</em> is negative, its absolute value is assumed to be the resource ID of an icon within an executable file. Specify the desired width of the icon in <em>IconWidth</em>. If the icon group indicated by <em>IconNumber</em> contains multiple icon sizes, the closest match is used and the icon is scaled to the specified size. See the Examples section for usage examples.</p>
    77. 

  77. <p>Currently it is necessary to specify "actual size" when setting the icon to preserve transparency on Windows Vista and later. For example:</p>
    78. 

  78. <pre>Menu, MenuName, Icon, MenuItemName, Filename.png,, 0</pre>
    79. 

  79. <p>Known limitation: Icons on Gui menu bars are positioned incorrectly on Windows XP and older.</p>
    80. 

  80. <p><span class="ver">[v1.1.23+]:</span> A <a href="../misc/ImageHandles.htm">bitmap or icon handle</a> can be used instead of a filename. For example, <code>HBITMAP:%handle%</code>.</p>
    81. 

  81. <p><strong>NoIcon, MenuItemName</strong>: Removes <em>MenuItemName</em>'s icon, if any.
    82. 

  82. <h2>Change the Tray Icon or ToolTip <span class="ver">(<em>MenuName</em> must be TRAY)</span></h2>
    83. 

  83. <p id="Icon"><strong>Icon [, FileName, IconNumber, 1]</strong>: Changes the script's icon to one of the ones from <em>FileName</em>. The following types of files are supported: ICO, CUR, ANI, EXE, DLL, CPL, SCR, and other types that contain icon resources. To use an icon group other than the first one in the file, specify its number for <em>IconNumber</em> (if omitted, it defaults to 1). For example, <strong>2</strong> would load the default icon from the second icon group. If <em>IconNumber</em> is negative, its absolute value is assumed to be the resource ID of an icon within an executable file. Specify an asterisk (*) for <em>FileName</em> to restore the script to its default icon.</p>
    84. 

  84. <p>The last parameter: Specify 1 for the last parameter to freeze the icon, or 0 to unfreeze it (or leave it blank to keep the frozen/unfrozen state unchanged). When the icon has been frozen, <a href="Pause.htm">Pause</a> and <a href="Suspend.htm">Suspend</a> will not change it. Note: To freeze or unfreeze the <em>current</em> icon, use 1 or 0 as in the following example: <code>Menu, Tray, Icon,,, 1</code>.</p>
    85. 

  85. <p>Changing the tray icon also changes the icon displayed by <a href="InputBox.htm">InputBox</a>, <a href="Progress.htm">Progress</a>, and subsequently-created <a href="Gui.htm">GUI</a> windows. <a href="../Scripts.htm#ahk2exe">Compiled scripts</a> are also affected even if a custom icon was specified at the time of compiling. Note: Changing the icon will not unhide the tray icon if it was previously hidden by means such as <a href="_NoTrayIcon.htm">#NoTrayIcon</a>; to do that, use <code>Menu, Tray, Icon</code> (with no parameters).</p>
    86. 

  86. <p id="distort">Slight distortion may occur when loading tray icons from file types other than .ICO. This is especially true for 16x16 icons. To prevent this, store the desired tray icon inside a .ICO file.</p>
    87. 

  87. <p>There are some icons built into the operating system's DLLs and CPLs that might be useful. For example: <code>Menu, Tray, Icon, Shell32.dll, 174</code>.</p>
    88. 

  88. <p>The built-in variables <strong>A_IconNumber</strong> and <strong>A_IconFile</strong> contain the number and name (with full path) of the current icon (both are blank if the icon is the default).</p>
    89. 

  89. <p><span class="ver">[v1.1.23+]:</span> A <a href="../misc/ImageHandles.htm">bitmap or icon handle</a> can be used instead of a filename. For example, <code>HBITMAP:%handle%</code>.</p>
    90. 

  90. <p><strong>Icon</strong> (with no parameters): Creates the tray icon if it isn't already present. This will override <a href="_NoTrayIcon.htm">#NoTrayIcon</a> if that directive is also present in the script.</p>
    91. 

  91. <p><strong>NoIcon</strong>: Removes the tray icon if it exists. If this command is used at the very top of the script, the tray icon might be briefly visible when the script is launched. To prevent that, use <a href="_NoTrayIcon.htm">#NoTrayIcon</a> instead. The built-in variable <strong>A_IconHidden</strong> contains 1 if the tray icon is currently hidden or 0 otherwise.</p>
    92. 

  92. <p><strong>Tip [, Text]</strong>: Changes the tray icon's tooltip -- which is displayed when the mouse hovers over it. To create a multi-line tooltip, use the linefeed character (`n) in between each line, e.g. Line1`nLine2. Only the first 127 characters of <em>Text</em> are displayed, and <em>Text</em> is truncated at the first tab character, if present. If <em>Text</em> is omitted, the tooltip is restored to its default text. The built-in variable <strong>A_IconTip</strong> contains the current text of the tooltip (blank if the text is at its default).</p>
    93. 

  93. <h2>Miscellaneous Commands</h2>
    94. 

  94. <p id="Show"><strong>Show [, X, Y]</strong>: Displays <em>MenuName</em>, allowing the user to select an item with arrow keys, menu shortcuts (underlined letters), or the mouse. Any menu can be shown, including the tray menu but with the exception of <a href="Gui.htm">GUI</a> menu bars. If both X and Y are omitted, the menu is displayed at the current position of the mouse cursor. If only one of them is omitted, the mouse cursor's position will be used for it. X and Y are relative to the active window. Specify &quot;<a href="CoordMode.htm">CoordMode</a>, Menu&quot; beforehand to make them relative to the entire screen.</p>
    95. 

  95. <p><strong>Color, ColorValue [, Single]</strong>: Changes the background color of the menu to <em>ColorValue</em>, which is one of the 16 primary HTML color names or a 6-digit RGB color value (see <a href="Progress.htm#colors">color chart</a>). Leave <em>ColorValue</em> blank (or specify the word Default) to restore the menu to its default color. If the word Single is not present as the next parameter, any submenus attached to this menu will also be changed in color.</p>
    96. 

  96. <p><strong>Click, ClickCount</strong>: Specify 1 for <em>ClickCount</em> to allow a single-click to activate the tray menu's default menu item. Specify 2 for <em>ClickCount</em> to return to the default behavior (double-click). For example: <code>Menu, Tray, Click, 1</code>.</p>
    97. 

  97. <p id="MainWindow"><strong>MainWindow</strong>: This command affects <a href="../Scripts.htm#ahk2exe">compiled scripts</a> only. It allows the script's main window to be opened via the tray icon, which is otherwise impossible. It also enables the items in the main window's View menu such as &quot;Lines most recently executed&quot;, which allows viewing of the script's source code and other info. <em>MenuName</em> must be TRAY.</p>
    98. 

  98. <p><strong>NoMainWindow</strong> (default): This command affects <a href="../Scripts.htm#ahk2exe">compiled scripts</a> only. It restores the script to its default behavior, that is, it prevents the main window from being opened. Even while this option is in effect, the following commands are still able to show the main window when they are encountered in the script at runtime: <a href="ListLines.htm">ListLines</a>, <a href="ListVars.htm">ListVars</a>, <a href="ListHotkeys.htm">ListHotkeys</a>, and <a href="KeyHistory.htm">KeyHistory</a>. <em>MenuName</em> must be TRAY.</p>
    99. 

  99. <p><strong>UseErrorLevel [, off]</strong>: If this option is never used in the script, it defaults to OFF. The OFF setting displays a dialog and terminates the <a href="../misc/Threads.htm">current thread</a> whenever the Menu command generates an error. Specify <code>Menu, Tray, UseErrorLevel</code> to prevent the dialog and thread termination; instead, <a href="../misc/ErrorLevel.htm">ErrorLevel</a> will be set to 1 if there was a problem or 0 otherwise. To turn this option back off, specify OFF for the next parameter. This setting is global, meaning it affects all menus, not just <em>MenuName</em>.</p>
    100. 

  100. 

  101. <h2 id="Win32_Menus">Win32 Menus</h2>
    102. 

  102. <p>As items are added to a menu or modified, the name and other properties of each item are recorded by the Menu command, but the actual <a href="https://msdn.microsoft.com/en-us/library/ms646977">Win32 menu</a> is not constructed immediately. This occurs when the menu or its parent menu is attached to a GUI or shown, either  for the first time or if the menu has been "destroyed" since it was last shown. Any of the following can cause this Win32 menu to be destroyed, along with any parent menus and submenus:</p>
    103. 

  103. <ul>
    104. 

  104.   <li>Deleting a menu.</li>
    105. 

  105.   <li>Replacing an item's submenu with a label or a different menu.</li>
    106. 

  106.   <li>Menu, <em>MenuName</em>, <strong>DeleteAll</strong>.</li>
    107. 

  107.   <li>Menu, <em>MenuName</em>, <strong>NoStandard</strong> (if the standard items were present).</li>
    108. 

  108. </ul>
    109. 

  109. <p>Any modifications which are made to the menu directly by Win32 API calls only apply to the current "instance" of the menu, and are lost when the menu is destroyed.</p>
    110. 

  110. <p>Each menu item is assigned an ID when it is first added to the menu. Scripts cannot rely on an item receiving a particular ID, but can retrieve the ID of an item by using GetMenuItemID as shown in the <a href="MenuGetHandle.htm#Examples">MenuGetHandle example</a>. This ID cannot be used with the Menu command, but can be used with various <a href="https://msdn.microsoft.com/en-us/library/ms646977">Win32 functions</a>.</p>
    111. 

  111. 

  112. <h2>Remarks</h2>
    113. 

  113. <p>The names of menus and menu items can be up to 260 characters long.</p>
    114. 

  114. <p>Separator lines can be added to the menu by using <code>Menu, <i>MenuName</i>, Add</code> (i.e. omit all other parameters). To delete separator lines individually, identify them by their position in the menu (requires v1.1.23+). For example, use <code>Menu, <i>MenuName</i>, Delete, 3&amp;</code> if there are two items preceding the separator. Alternatively, use <code>Menu, <i>MenuName</i>, DeleteAll</code> and then re-add your custom menu items.</p>
    115. 

  115. <p>New menu items are always added at the bottom of the menu. For the tray menu: To put your menu items on top of the standard menu items (after adding your own menu items) run <code>Menu, Tray, NoStandard</code> followed by <code>Menu, Tray, Standard</code>.</p>
    116. 

  116. <p>The standard menu items such as &quot;Pause Script&quot; and &quot;Suspend Hotkeys&quot; cannot be individually operated upon by any menu sub-command.</p>
    117. 

  117. <p>If a menu ever becomes completely empty -- such as by using <code>Menu, MyMenu, DeleteAll</code> -- it cannot be shown. If the tray menu becomes empty, right-clicking and double-clicking the tray icon will have no effect (in such cases it is usually better to use <a href="_NoTrayIcon.htm">#NoTrayIcon</a>).</p>
    118. 

  118. <p>If a menu item's subroutine is already running and the user selects the same menu item again, a new <a href="../misc/Threads.htm">thread</a> will be created to run that same subroutine, interrupting the previous thread. To instead buffer such events until later, use <a href="Critical.htm">Critical</a> as the subroutine's first line  (however, this will also buffer/defer other threads such as the press of a hotkey).</p>
    119. 

  119. <p>Whenever a  subroutine is launched via a menu item, it starts off fresh with the default values for settings such as <a href="SendMode.htm">SendMode</a>. These defaults can be changed in the <a href="../Scripts.htm#auto">auto-execute section</a>.</p>
    120. 

  120. <p>The built-in variables <strong><a href="../Variables.htm#ThisMenuItem">A_ThisMenuItem</a></strong> and <strong><a href="../Variables.htm#ThisMenuItemPos">A_ThisMenuItemPos</a></strong> contain the name and position of the custom menu item most recently selected by the user (blank if none). Similarly, <strong>A_ThisMenu</strong> is the name of the menu from which <strong>A_ThisMenuItem</strong> was selected. These variables are useful when building a menu whose contents are not always the same. In such a case, it is usually best to point all such menu items to the same label and have that label refer to the above variables to determine what action to take.</p>
    121. 

  121. <p>To keep a non-hotkey, non-<a href="Gui.htm">GUI</a> script running -- such as one that contains only custom menus or menu items -- use <a href="_Persistent.htm">#Persistent</a>.</p>
    122. 

  122. <h2>Related</h2>
    123. 

  123. <p><a href="Gui.htm">GUI</a>, <a href="../misc/Threads.htm">Threads</a>, <a href="Thread.htm">Thread</a>, <a href="Critical.htm">Critical</a>, <a href="_NoTrayIcon.htm">#NoTrayIcon</a>, <a href="Gosub.htm">Gosub</a>, <a href="Return.htm">Return</a>, <a href="SetTimer.htm">SetTimer</a>, <a href="_Persistent.htm">#Persistent</a></p>
    124. 

  124. <h2>Examples</h2>
    125. 

  125. <pre class="NoIndent"><em>; EXAMPLE #1: This is a working script that adds a new menu item to the bottom of the tray icon menu.</em>
    126. 

  126. 

  127. #Persistent  <em>; Keep the script running until the user exits it.</em>
    128. 

  128. Menu, tray, add  <em>; Creates a separator line.</em>
    129. 

  129. Menu, tray, add, Item1, MenuHandler  <em>; Creates a new menu item.</em>
    130. 

  130. return
    131. 

  131. 

  132. MenuHandler:
    133. 

  133. MsgBox You selected %A_ThisMenuItem% from menu %A_ThisMenu%.
    134. 

  134. return</pre>
    135. 

  135. <p>&nbsp;</p>
    136. 

  136. <pre class="NoIndent"><em>; EXAMPLE #2: This is a working script that creates a popup menu that is displayed when the user presses the Win-Z hotkey.</em>
    137. 

  137. 

  138. <em>; Create the popup menu by adding some items to it.</em>
    139. 

  139. Menu, MyMenu, Add, Item1, MenuHandler
    140. 

  140. Menu, MyMenu, Add, Item2, MenuHandler
    141. 

  141. Menu, MyMenu, Add  <em>; Add a separator line.</em>
    142. 

  142. 

  143. <em>; Create another menu destined to become a submenu of the above menu.</em>
    144. 

  144. Menu, Submenu1, Add, Item1, MenuHandler
    145. 

  145. Menu, Submenu1, Add, Item2, MenuHandler
    146. 

  146. 

  147. <em>; Create a submenu in the first menu (a right-arrow indicator). When the user selects it, the second menu is displayed.</em>
    148. 

  148. Menu, MyMenu, Add, My Submenu, :Submenu1
    149. 

  149. 

  150. Menu, MyMenu, Add  <em>; Add a separator line below the submenu.</em>
    151. 

  151. Menu, MyMenu, Add, Item3, MenuHandler  <em>; Add another menu item beneath the submenu.</em>
    152. 

  152. return  <em>; End of script's auto-execute section.</em>
    153. 

    154. 

  154. MenuHandler:
    155. 

  155. MsgBox You selected %A_ThisMenuItem% from the menu %A_ThisMenu%.
    156. 

  156. return
    157. 

  157. 

  158. #z::Menu, MyMenu, Show  <em>; i.e. press the Win-Z hotkey to show the menu.</em></pre>
    159. 

  159. <p>&nbsp;</p>
    160. 

  160. <pre class="NoIndent"><em>; EXAMPLE #3: This is a working script that demonstrates some of the various menu commands.</em>
    161. 

  161. 

  162. #Persistent
    163. 

  163. #SingleInstance
    164. 

  164. menu, tray, add <em>; separator</em>
    165. 

  165. menu, tray, add, TestToggle&amp;Check
    166. 

  166. menu, tray, add, TestToggleEnable
    167. 

  167. menu, tray, add, TestDefault
    168. 

  168. menu, tray, add, TestStandard
    169. 

  169. menu, tray, add, TestDelete
    170. 

  170. menu, tray, add, TestDeleteAll
    171. 

  171. menu, tray, add, TestRename
    172. 

  172. menu, tray, add, Test
    173. 

  173. return
    174. 

  174. 

  175. <em>;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;</em>
    176. 

  176. 

  177. TestToggle&amp;Check:
    178. 

  178. menu, tray, ToggleCheck, TestToggle&amp;Check
    179. 

  179. menu, tray, Enable, TestToggleEnable <em>; Also enables the next test since it can't undo the disabling of itself.</em>
    180. 

  180. menu, tray, add, TestDelete <em>; Similar to above.</em>
    181. 

  181. return
    182. 

  182. 

  183. TestToggleEnable:
    184. 

  184. menu, tray, ToggleEnable, TestToggleEnable
    185. 

  185. return
    186. 

  186. 

  187. TestDefault:
    188. 

  188. if default = TestDefault
    189. 

  189. {
    190. 

  190.     menu, tray, NoDefault
    191. 

  191.     default =
    192. 

  192. }
    193. 

  193. else
    194. 

  194. {
    195. 

  195.     menu, tray, Default, TestDefault
    196. 

  196.     default = TestDefault
    197. 

  197. }
    198. 

  198. return
    199. 

  199. 

  200. TestStandard:
    201. 

  201. if standard &lt;&gt; n
    202. 

  202. {
    203. 

  203.     menu, tray, NoStandard
    204. 

  204.     standard = n
    205. 

  205. }
    206. 

  206. else
    207. 

  207. {
    208. 

  208.     menu, tray, Standard
    209. 

  209.     standard = y
    210. 

  210. }
    211. 

  211. return
    212. 

  212. 

  213. TestDelete:
    214. 

  214. menu, tray, delete, TestDelete
    215. 

  215. return
    216. 

  216. 

  217. TestDeleteAll:
    218. 

  218. menu, tray, DeleteAll
    219. 

  219. return
    220. 

  220. 

  221. TestRename:
    222. 

  222. if NewName &lt;&gt; renamed
    223. 

  223. {
    224. 

  224.     OldName = TestRename
    225. 

  225.     NewName = renamed
    226. 

  226. }
    227. 

  227. else
    228. 

  228. {
    229. 

  229.     OldName = renamed
    230. 

  230.     NewName = TestRename
    231. 

  231. }
    232. 

  232. menu, tray, rename, %OldName%, %NewName%
    233. 

  233. return
    234. 

  234. 

  235. Test:
    236. 

  236. MsgBox, You selected &quot;%A_ThisMenuItem%&quot; in menu &quot;%A_ThisMenu%&quot;.
    237. 

  237. return</pre>
    238. 

  238. <pre class="NoIndent"><em>; EXAMPLE #4: This is a working script that adds icons to its menu items.</em>
    239. 

  239. Menu, FileMenu, Add, Script Icon, MenuHandler
    240. 

  240. Menu, FileMenu, Add, Suspend Icon, MenuHandler
    241. 

  241. Menu, FileMenu, Add, Pause Icon, MenuHandler
    242. 

  242. Menu, FileMenu, Icon, Script Icon, %A_AhkPath%, 2 <em>;Use the 2nd icon group from the file</em>
    243. 

  243. Menu, FileMenu, Icon, Suspend Icon, %A_AhkPath%, -206 <em>;Use icon with resource identifier 206</em>
    244. 

  244. Menu, FileMenu, Icon, Pause Icon, %A_AhkPath%, -207 <em>;Use icon with resource identifier 207</em>
    245. 

  245. Menu, MyMenuBar, Add, &amp;File, :FileMenu
    246. 

  246. Gui, Menu, MyMenuBar
    247. 

  247. Gui, Add, Button, gExit, Exit This Example
    248. 

  248. Gui, Show
    249. 

  249. MenuHandler:
    250. 

  250. Return
    251. 

  251. 

  252. Exit:
    253. 

  253. ExitApp
    254. 

  254. </pre>
    255. 

  255. </body>
    256. 

  256. </html>
    257. 

  257.