<< Startup | Table of Contents | Using Hot Keyboard >>

Macro Launch Conditions

When you click the Change button in Macro Properties... window, the following dialog is displayed:

Here you can set macro execution conditions, thus macro is executed if only all conditions are met

Window title contains - set the text that active window title must contain. You can select from the list of currently active windows, however you can edit it manually.

Examples:

Execute macro when Internet Explorer is active:
Internet Explorer
Execute macro when a specified web page is opened is active:
Hot Keyboard Home page
Execute macro when a web browser is active:
Internet Explorer;Chrome;Mozilla

The Window class name condition allows executing the macro only if the class name of the active window contains the specified string (each window in the Windows world belongs to some window class; if you are unsure about class name of a window, Hot Keyboard lists currently available classes in the drop down list).

The Process name condition allows the macro to be executed only if the process that created the currently active window has a name that contains the given string. Using this condition group, you can create a macro that works only within one application - e.g. you may wish to pause and resume Windows Media Player by clicking the Space key. But its foreground window does not have a title when the player is switched to the full screen mode, so window title condition is inappropriate for this purpose.

Examples:

Execute macro if Windows Media Player is active
wmplayer.exe

Expression - you can put a scripting expression here; when the macro is about to be executed, Hot Keyboard computes the expression and executes the macro only if the result is not equal to 0. To read more about arithmetic expressions supported by Hot Keyboard and their computation, please refer to the Scripting documentation.

If more than one condition is set for a macro (e.g. both the window title and the process name conditions are set), Hot Keyboard executes the macro only if all conditions are satisfied.

Examples:

Execute macro between 12:00 - 12:59
FormatTime("%H") ="12"
Execute macro if there is a text selected in active application
StrLen( Selection () ) > 0

All user-defined strings (except Expression) that are used to test the macro execution conditions may have multiple entries separated with semicolon ( ; ).

Invert - execute macro if the rule does not match