Menu 0.82

Nathan Moore

Step.rc Settings

MenuPrefix <text>
All other step.rc settings are read by menu prefixed with the given text, including the * lines. For example if the string Fred is given for this setting menu will look for settings like *Fred and FredNoTitles. By setting this to Popup or bPopup menu can masquerade as either of those modules. The rest of this document uses "[Prefix]" to represent the text given in this setting. This is a breaking change from the previous version.
Default: Menu
[Prefix]NoTitles
Do not show menu headers. This setting is also found in Popup2, however unlike in Popup2 if this is present no menu headings will be shown on top level menus.
[Prefix]ShowExtension
Show file name extensions on items in a !PopupDynamicFolder, !DynamicFolder, or a !PopupFolder. This setting is also found in Popup2.
[Prefix]AutoColumn
Makes generated menus use multiple columns instead of scrolling.
[Prefix]HorzAnimation <off, right, left>
Controls the way the menus is animated when displaying. If menu animation is turned off at the system level these settings have no effect. Any on position will result in the "Fade Effect" if it is enabled at the system level.
Default: off
[Prefix]VertAnimation <off, up, down>
See [Prefix]HorzAnimation
Default: off
[Prefix]HorzPosition <left, center, right>
Controls were the menu is drawn relative to the mouse. Popup2 offers these as bang command paramaters.
Default: left
[Prefix]VertPosition <top, center, bottom>
See [Prefix]HorzPosition
Default: top
[Prefix]HotlistName <text>
Default: Litestep

* Lines

Popup2 allows a .icon setting in the * lines while menu does not support icons if these are left in menu will simply ignore them.

Menu allows you to specify multiple popup menus. These popups are described by *[Prefix] lines which form a hierarchy detailing the exact entries of your popup. The top level of the hierarchy is defined by a pair of lines like:

or Where “Header” is the text that appears at the top of the menu if [Prefix]NoTitles is not present. “BangName” as one would expect gives the bang command that is used to invoke this popup.

Between the two new line goes a varitey of differnt lines. There is only one other setting that requires more than one line. It looks like this:

And allows you to add a subfolder and specify it's exact contents to your popup.

Single Item

When selected from your popup these will cause the file or bang command to be executed (or opened). A right click on the entry will cause the context menu for the file to be displayed. Bang Commands do not have context menus.
This creates a entry reflecting the current time, updating immeditly before display. The format string is specified as described here
Insert a standard windows' menu separator into the menu.

Automaticly Generated folders

All of these folder types can be inserted into the current menu, rather than into their ownd submenu, by placing the word insert at the end of the their line. For details on !PopupFolder keep reading.
Creates a submenu contain the contents of the given folder. The two dynamic versions reload the contents of the menu before each display. The nondynamic version loads the contents of the folder before the first display and caches it util a recyle or the module is reloaded.
These create a dynamic folder listing the contents of a virtual shell folder. For these items the "Name" can be omited and Menu will autodected the name of the folder.
Creates a submenu that has previous, play, pause, stop, next controls for winamp. If name is a path to a image, as popup2 uses the default text is used.
Creates a submenu that contains the current contents of the taskbar.

Formating Items

Indicates a column break.

Sample Config