MOVE WINDOW

From Recital Documentation Wiki
Jump to: navigation, search

Purpose

Move a pre-defined window to a new position


Syntax

MOVE WINDOW <window-name> TO <row, col>| BY <expN1, expN2> | CENTER | SCREEN


See Also

ACTIVATE SCREEN, ACTIVATE WINDOW, CLEAR WINDOWS, DEACTIVATE WINDOW, DEFINE WINDOW, HIDE WINDOW, RELEASE WINDOWS, RESIZE WINDOW, RESTORE WINDOW, SAVE WINDOW, SHOW WINDOW, WCOLS(), WEXIST(), WONTOP(), WOUTPUT(), WROWS(), WTITLE(), WVISIBLE()


Description

The MOVE WINDOW command is used to move a window to a new screen position. A window is an area of the screen designated for output and input. Windows are defined with the DEFINE WINDOW command, and are displayed to the screen with the ACTIVATE WINDOW or SHOW WINDOW commands. There is no limit to the number of defined windows. The <window-name> is the name of the window as defined in the DEFINE WINDOW command. A window definition must include the FLOAT keyword for the window to be moveable.

Windows can be moved using the TO <row, col> clause, using the BY <expN1, expN2> clause or centered using the CENTER keyword. The TO clause moves the window so that the upper left corner is positioned at the specified row and column coordinates. The BY clause moves the upper right corner of the window vertically by the number of rows specified in <expN1>, and horizontally by the number of columns specified in <expN2>. The CENTER keyword centers the window in the screen.

The SCREEN keyword is included for language compatibility only.


Example

procedure move_up
  move window browse by -1,0
return
procedure move_down
  move window browse by 1,0
return
procedure move_left
  move window browse by 0,-1
return
procedure move_right
  move window browse by 0,1
return
 
set procedure to movewin
set key -1 to move_up
set key -2 to move_down
set key -3 to move_right
set key -4 to move_left


Products

Recital