Wait - For pointer
Declaration
<AMWAIT ACTIVITY="pointer" ACTION="text (options)" POINTER="text (options)" />
Description
Causes task execution to suspend at the current step until the mouse cursor matches or differs from the cursor type specified or until any cursor change transpires.
Practical usage
Commonly used to wait for the mouse pointer to change from a 'Busy' or 'Working in background' state back to a 'Normal select' state to indicate that processing has completed.
Parameters
General
Property | Type | Required | Default | Markup | Description |
---|---|---|---|---|---|
Pointer condition | Text (options) | Yes | Match |
|
The pointer condition to wait for. The available options are:
|
Pointer to wait for | Text (options) | Yes | (Empty) |
|
The type of pointer to wait for. The list of available pointers should match the ones that appear in the Pointers property of your mouse settings. To specify a pointer, simply select it from the list of available pointers. |
Example
- Copy and paste the sample AML code below directly into the Task Builder Steps Panel.
- To successfully run the sample code, update parameters containing user credentials, files, file paths, or other information specific to the task to match your environment.
Example 1
Wait for pointer to match a busy pointer.
<AMWAIT ACTIVITY="pointer" POINTER="busy" />
Example 2
Wait for pointer to differ from a WorkingBackground pointer.
<AMWAIT ACTIVITY="pointer" WAITMODE="differ" POINTER="workinginbackground" />
Example 3
Wait until the pointer changes to any pointer other than the current pointer.
<AMWAIT ACTIVITY="pointer" WAITMODE="any" />