enable click hook


Specifies whether, after a click-related built-in action is executed and fails to register, a second attempt is made with the hook mechanism enabled. (Learn more.) Enabling of hook helps ensure a successful click.

Allowable values

Enables hook.
Disables hook.

Default value


Applicable Systems/Platforms

Use of this built-in setting is supported on the following systems/platforms:
  • Windows: Win32 applications.

Applicable Built-in Actions


  • This built-in setting affects only single left-click and right-click types.
  • Use this built-in setting to avoid problems that can result from unstable network connections, virtual machines, remote desktops, etc. Such issues may cause click-related built-in actions to unexpectedly fail to register with the AUT.
  • This built-in setting is not displayed in the editor by Content Assist. To use it in the editor, you must manually enter the setting name and its value.
  • The use of hooks tends to slow down the system because they increase the amount of processing the system must perform for each message. Hence it is recommended that you use enable click hook only as a last resort, and disable it as soon as possible. Preferred alternatives for addressing the issue of lost mouse clicks are the built-in settings click delay and click method.


Under various test environment conditions, your click-related built-in actions may fail to properly register with the AUT. Setting enable click hook to yes directs TestArchitect to re-execute such built-in actions when they do fail, in each case with the hook mechanism enabled on the subsequent attempt.