Properties

Here you can set a trigger and other properties of the current QM item.

 

Trigger

A trigger is an event that causes the item to run. Here you can set hotkey, mouse, window, QM events, file, event log, process, accessible object, autotext or a user-defined trigger. Here you can also set command line triggers (scheduler, shortcut) or copy the command line string to use by other program that can launch QM using command line or SendMessage. Other ways to launch macros: menus, toolbars, text, some functions (mac, tim, RunTextAsMacro, etc) and the Run button on the QM toolbar.

 

Programs

Program where this trigger works. Must be only filename, without path and .exe. Can also be several programs, comma-delimited. Example: NOTEPAD,CALC. You can see program name in QM status bar when mouse pointer is on a window of that program. Programs also can be set for all items in folder or file.

 

FF

Assign a filter function.

 

Schedule

Schedule this QM item to run at a specified time. QM uses Windows Task Scheduler, and you actually create its scheduled tasks. See also: command line, unlock computer. This feature is unavailable in portable QM.

 

Shortcut

Create a shortcut on the desktop, Start Menu or Quick Launch toolbar. When you click the shortcut, starts QM (if not already running), and launches this item. This feature is unavailable in portable QM.

 

Cmdline

Format command line to launch this item, and copy it to the clipboard.

 

Multi-trigger

Create a shortcut-macro and open its Properties dialog.

 

A macro itself cannot have multiple triggers, but you can use shortcut-macros and assign triggers to them. A shortcut-macro is a macro that begins with space, slash and target macro name or GUID, like  /TargetMacroName. When launched, actually runs the target macro. If the shortcut-macro has a trigger, the trigger will launch the target macro.

 

My Macros

See what triggers of selected type already exist (to avoid duplicate triggers).

 

Disable

Disable trigger. Disabled item still can be started using the Run button, mac, from menus and toolbars.

 

Common properties

These properties are common to all item types (macros, menus, etc).

 

Template

If checked, current item will be added to the 'File\New\Templates' menu. If item name is "Macro", "Function", "Menu", "Toolbar", "Autotext" or "Member", it replaces default "File\New" menu item. If there are multiple templates where name begins with same word followed by space or underscore, they are added to a submenu.

 

Macro properties

If a macro is running

Select what to do when this macro is launched while a macro (this or other) is running. By default multiple macros cannot run simultaneously like QM items of other types (e.g., functions).

 

QM 2.4.2. Added option 'Run simultaneously'. In previous QM versions, to run simultaneously, would need to convert the macro to function. Now you can use this option instead. The macro will have some traits of functions, read more here.

 

Convert to function

Converts the macro to function. May change its name because it must be a valid identifier (no spaces etc).

 

Function properties

Allow single instance

If checked, this function will not run when you launch it while it (its thread) is already running. This is applied only to normal threads, but not to special threads and functions called from code. Or you can add this at the beginning of function's code: if(getopt(nthreads)>1) ret.

 

Use as filter function

If checked, this function can be used as filter function. Filter functions are used with triggers, to narrow trigger scope and achieve various other effects.

 

Properties common to macros and functions

Can run

Set allowed launch methods. For example, to prevent accidentally launching the function, you can select "No, can only be called" or "Yes, except the Run button". You can also set to run some other macro or function instead. This option is saved in macro text (the first line), so you also can quickly edit without the Properties dialog. Read more.

 

Run in separate process

Read in Make exe topic. To run a macro in separate process, QM creates and runs exe or qmm file.

 

Run as

UAC integrity level of the macro process. Read Make exe, UAC.

 

Don't run in background; If computer locked, unlock

Read Unlock computer topic.

 

Menu properties

Here you can set menu properties.

 

Toolbar properties

Here you can set toolbar properties.

 

Autotext properties

Here you can set autotext list options.

 

Member function properties

 

Folder properties, File properties

To set folder properties, right click a folder and select Folder Properties in the menu.