Purpose

WINLOCATE specifies or changes the screen coordinates of a window.
 

Syntax

WINLOCATE("cycle tagname",row,col) -or- WINLOCATE(LS-num,row,col) 
 

Operation

cycle tagname should be an alphanumeric literal.

LS-num is the number of the windowed cycle.  If an invalid number is specified, the command is ignored and processing continues.

row,col are the coordinates of the top left hand corner of the window.  If these are such that any part of the window would be positioned off the screen, then they are adjusted minimally so that the whole window is just brought onto the screen.

Remarks

The coordinates remain as set by WINLOCATE until changed by another WINLOCATE or other window relocation method.  

WINLOCATE does not invoke the window it only specifies its coordinates.  

It may be invoked by following the WINLOCATE statement with an LSCALL statement, or by the end-user pressing WINDOW.  

If the window is already displayed when this command is issued it is re-displayed at the new location.  Any (non-window) embedded cycles are moved along with the parent cycle.