WinMenu ReadMe.txt
------------------

This is a WindowBlinds plugin created to add a custom button/menu to a window's title bar. It loads a list of application links from the Registry that it presents via a standard Windows popup menu.
Because the menu is based from the registry, once configured, it does not change regardless of the skin you are using, although you must add a button to trigger the menu for each skin you wish to access the WinMenu from.



In this zip is a sample registry file for adding some default items to the menu. Currently you have to edit the registry to add or edit additional entries to your menu. The source is included in this package.


If you are interested in adding a WinMenu to your skin you really only need:

 - the WinMenu.dll file
 - a [Button] added to the uis file similar to that below.
 - registry entries defining your desired menu contents.


----------------------
The UIS button:
----------------------

DllName =	; the location of the plugin.

ButtonImage =	; this is your WinMenu button,
                    same image format as any WB titlebar button
Height =
Width =		; pixel size of the button image. MUST be present.

Action = -4	; tells WB this is a dll button, and WB draws the button.
                    MUST be present, MUST be this value.
Align =
XCoord =
YCoord =
Visibility =	; standard button attributes. set as desired.

sample:
----------------------
[Button#]
DllName = WinMenu\WinMenu.dll
ButtonImage = skin folder\WinMenu.bmp
Height = 16
Width = 16
Action = -4
Align = 1
XCoord = 100
YCoord = 14
Visibility = 1



----------------------
The registry entries:
----------------------

This is the base level for the menu:

\HKCU\Software\WinMenu\WindowBlindsEx\Settings\
	
- Key are directories (nodes)
- Strings under keys are items (leaves)



Example:
----------------------

[HKEY_CURRENT_USER\Software\WinMenu\WindowBlindsEx\Settings]
"E&xplorer"="Explorer.exe"

; would give a link to 'Explorer' in the main menu.
; Note the use of the '&' character to enable a keypress of 'x' to launch the app.

	
Example 2:
----------------------

[HKEY_CURRENT_USER\Software\WinMenu\WindowBlindsEx\Settings]
"E&xplorer"="Explorer.exe"

[HKEY_CURRENT_USER\Software\WinMenu\WindowBlindsEx\Settings\Accessories]
"Calculator"="Calc.exe"

; would give a link to 'Explorer' in the main menu, with a sub-menu entitled 'Accessories' which contains a link for 'Calculator'.



- It is possible to specify the parameters and default directory for opening the application. Use commas to delimit the application,	parameters, and directory.

Example:
	
	String Value	 Data
	------------     ----
	Notepad          Notepad.exe,,d:\temp
	Autoexec         Notepad.exe,c:\autoexec.bat,c:\   



The order in which the menu entries appear in the WinMenu appears to follow this pattern:

- all submenus (subkeys) will come after (below) root entry application links.
- all entries (keys and strings) will appear in reverse order to the way they are ordered in the registry file.

Example:

	"Paintbrush"="pbrush.exe"
	"Calculator"="Calc.exe"
	"RegEdit"="Regedit.exe"

- if the reg file lists these apps like above, they will appear in the WinMenu like this:

	RegEdit
	Calculator
	Paintbrush



----------------------



The most recent version of this plugin can always be found at the BuilderBlinds website:  http://welcome.to/BuilderBlinds

Thanks to Adam Najmanowicz (author of BuilderBlinds) and d for offering to host this software on the BB website and it's mirrors.

Both this text readme/help file and the html version were created by d, based upon an early version by Shane Lardino.


Regards,
Shane
lardino@ibm.net
