Triggers: Shell menu

Adds the macro to the shell context menu. It is the popup menu that appears when you right-click a file in a folder window or desktop. To assign this trigger, use the Properties dialog. Unavailable in portable QM.

 

The macro runs when you click the menu item. It receives trigger information through the function statement:

 

 \
function $files

 

files - file path. If multiple files selected - list of paths.

 

 

Label

Menu item label. To add the item to a submenu, use path like Submenu\Macro. The submenu will be created automatically, or you can create it (read more below).

 

Single & character makes following character underlined. Use && for &.

 

QM 2.3.5. Single-hyphen (-) label creates separator.

 

Other fields are optional.

 

Include, File types

For what file types to show the menu item. By default, the macro is added to the menu for all files except folders. 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>.

 

QM 2.3.5. Works with drives too, like with folders. If need only drives, use ?:\ in Folders field. If need only folders, use ?:\ and check Not.

 

QM 2.3.5. You can set to display the menu item when user right clicks in desktop or folder backround, not on a file. The macro will receive full path of the folder.

 

Folders

Multiline list of folders where the menu item will be added or Not added. The menu item will be in subfolders too.

 

QM 2.3.5. Can be used wildcard characters. Then compared is whole path of the selected file, not just its parent folder.

 

Image file

An icon file for the menu item, eg $my qm$\copy.ico. Can be ico, bmp or other file. You can specify icon index, eg icons.dll,4. Don't use many icons from executable files, because they are extracted slowly.

 

Description

Text to display in status bar.

 

Submenu

If checked, it will be menu item that opens a submenu. The macro can be empty. Use this if you want to assign file types, icon or other properties to the submenu, because there is no way to assign properties to auto-created submenus.

 

Notes

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

 

QM 2.3.5. Trigger string now begins with $sm. Previously was ^Shell_menu. QM automatically converts it at startup. Previously this trigger type was implemented as user-defined trigger.

 

QM 2.3.5. Removed alphabetical sorting. Now menu items are ordered like in QM as they are when QM starts.

 

QM 2.3.5. Now icons don't disable menu theme.