Triggers: Shell menu

Adds the macro to the right-click menu (context menu) in folder windows (Windows Explorer). To assign this trigger, use the Properties dialog.

 

The macro runs when you click the menu item. It receives the list of selected files.

 

Label

Menu item label. To add it to a submenu, enter submenu label, backslash, and menu item label, eg Submenu\My Macro. The submenu will be created automatically if does not exist (read more below).

 

Other fields are optional.

 

Include, File types

For what files/folders to show the menu item. By default, the macro is added to the menu for all files. To add it only for certain file types, enter one or more extensions separated by space, eg txt doc rtf. For files with no extension, use <noextension>.

 

Folders

If you specify one or more strings in "Folders" field, the menu item will be displayed only if the path of the selected file(s) begins with one of these strings.

 

Image file

You can specify an icon file for the menu item, eg &my qm$\xxx.ico. It can be ico, bmp or other file. You can specify icon index, eg icons.dll,4. In the main menu don't use many icons from executable files, because they are extracted slowly.

 

Description

Text that Windows Explorer will display in the status bar.

 

Submenu

If checked, it will be menu item that opens submenu. The macro will not run and therefore can be empty.

 

You don't have to explicitly create macros for submenus, unless you want to assign file types, icon and description to the submenu. If you assign file types to a submenu, you don't have to assign file types to its child items, unless you want to assign them only some of these file types, or except some of these file types.

 

Notes

The number of menu items you can add is limited. On WinXP it is ~150.

 

Part of the trigger type is implemented as user-defined trigger. Another part is qmshlex.dll.