Wait for Pointer Action

Declaration

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

See Also

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:

match: Wait until the pointer matches at least one of the pointer(s) specified in the pointer [POINTER] parameter.

differ: Wait until the pointer does not match any of the pointer(s) specified in the pointer [POINTER] parameter.

any: Wait until the pointer changes to any pointer other than the current pointer at the time the step begins execution.

 

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:

NormalSelect
HelpSelect
WorkingInBackground
Busy
PrecisionSelect
TextSelect
Unavailable
VerticalResize
HorizontalResize
DiagonalResize1
DiagonalResize2
Move
AlternateSelect
LinkSelect

Notes

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 by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, a popup expression builder is available in all these fields by pressing F2.
More on variables...
More on expressions...
More on the expression builder...

Example

<AMWAITFORPOINTER POINTER="NormalSelect">

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

<AMWAITFORPOINTER ACTION="any">

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