Automation Guide Action-based testing language Built-in settings Other settings

 enable click hook

enable click hook

Description

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

• yes

  Enables hook.

• no

  Disables hook.

Default value

no

Applicable Systems/Platforms

Use of this built-in setting is supported on the following systems/platforms:

• Windows: Win32 applications.

Applicable Built-in Actions

Use of this built-in setting is applicable to the following built-in actions:

• click
• click list item
• click picture
• click select menu
• click table cell
• click text
• click toolbar button
• click tree node
• click window
• select
• select button menu
• select context menu item
• select list item menu
• select menu item
• select tab
• select toolbar menu

Notes

• 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.

Example

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.

Related information

click delay

click method