Command: uncursor

Syntax

uncursor

Description

Re-use the last interactive screen position.

Parameters

None

Switches

• -but=<num>
  Define a button number to be used for the next interactive screen operation. If omitted, the next interactive screen operation will re-use the result of the last interactive screen operation. The value of <num> should be non-zero.

• -can
  Cancel the uncursor setting.

• -pos=<screen_xy>
  Define a pair screen coordinates to be used for the next interactive screen operation. If this is omitted, the next interactive screen operation will re-use the result of the last interactive screen operation. <screen_xy> should be a 2-element numeric array, or two numeric values within hairpins. The values are in pixels with 0,0 being the top left corner of the master window.

Notes

Most commands and functions with interactive cursor input will operate in conjunction with uncursor.

Example

# Create an alpha window containing a file.
walpha my_file.dat
 
# Locate a word via interactive cursor action.
!*** Please point to a word ***; # Prompt
string sw = awword
 
# Use uncursor.
uncursor
 
# Get the text of the complete line at the same position.
string sl = awline
 
# Print confirmation.
tell <'Word found: ',sw>,<'Line found: ',sl>

See Also