Wait for Pointer Action

Declaration

<AMWAITFORPOINTER ACTION="options" POINTER="text (optional list)">

See Also

Wait for Pointer Action-Setting Properties, Wait for Window, Wait for Pixel, Wait for File, Wait for Process, Close Window

Description

Causes task execution to pause at the current line until the mouse pointer matches or differs from the specified pointer (cursor) type.

Practical Usage

Commonly used to wait for the mouse pointer to change from an hourglass (busy) back to an arrow (normal select) to indicate that processing has completed.

Parameters

General Tab

Action

Text, optional default match
MARKUP: ACTION="differ"

Specifies whether to wait for the pointer to match the specified pointer(s), differ from the specified pointer(s), or change to any other pointer.

The available options are:

 

Pointer to Wait For

Text, Required
MARKUP: POINTER="Normal"

Specifies the pointer type(s) that AutoMate should wait for. Multiple type(s) may be specified separated with commas.

The available pointer types are:

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMWAITFORPOINTER POINTER="NormalSelect">

<AMWAITFORPOINTER ACTION="differ" POINTER="WorkingInBackground,Busy">

<AMWAITFORPOINTER ACTION="any">

<AMWAITFORPOINTER POINTER="NormalSelect,PrecisionSelect,TextSelect,LinkSelect">