MOVE WINDOW Command

  • Article

Moves a user-defined window created with DEFINE WINDOW, or a Visual FoxPro system window (such as the Command window or Browse window) to a new location.

MOVE WINDOW WindowName TO nRow1, nColumn1   | BY nRow2, nColumn2 | CENTER

Parameters

  • WindowName
    Specifies the name of the window to move.
  • TO nRow1, nColumn1
    Moves the window to a location, specified by nRow1, nColumn1, in the main Visual FoxPro window or in a user-defined window.
  • BY nRow2, nColumn2
    Moves a window to a location relative to its current position. The numeric expression nRow2 specifies the number of rows to move the window (down if nRow2 is positive, up if negative). The numeric expression nColumn2 specifies the number of columns to move the window (to the right if nColumn2 is positive, to the left if negative).
  • CENTER
    Centers a window in the main Visual FoxPro window or in its parent window.

Remarks

A window can be moved to a specific position or relative to its current position. If a window is defined, it can be moved; it doesn't have to be active or visible.

To move a system window and or a toolbar (in Visual FoxPro), enclose the entire system window or toolbar name in quotation marks. For example, to move the Report Controls toolbar (when it isn't docked) in Visual FoxPro, issue the following command:

MOVE WINDOW "Report Controls" BY 1,1

Historically in prior versions of Visual FoxPro, the Data Session window has always been referred to as the View window. Additionally, language used to control this window, such as HIDE WINDOW, ACTIVATE WINDOW, WONTOP( ), also refers to this window as the View window. Visual FoxPro continues to refer to the View window for the MOVE WINDOW command.

Example

In the following example, after the window named wEnter is defined and activated, the window is moved.

DEFINE WINDOW wEnter FROM 10,4 TO 15,54 SYSTEM ;
   TITLE "Nomadic Window"
ACTIVATE WINDOW wEnter 
WAIT WINDOW 'Press any key to move the window'
MOVE WINDOW wEnter TO 20,15
WAIT WINDOW 'Press any key to center the window'
MOVE WINDOW wEnter CENTER
WAIT WINDOW 'Press any key to release the window'
RELEASE WINDOW wEnter

See Also

ACTIVATE WINDOW | WAIT Command | DEFINE WINDOW Command | DOCK WINDOW Command | WDOCKABLE( ) Function