MoveWindow
(Engine-Level Function)
Description: | Will move a window to the specified coordinates. |
Returns: | Nothing |
Usage: | Steady State only. |
Function Groups: | Graphics, Window |
Related to: | CurrentWindow | SizeWindow | WindowOptions |Window |
Format: | MoveWindow(Win, X, Y) |
Parameters: |
Win |
Required. Any expression that gives an object value contained in the window to move. Often, Self(). |
X |
Required. Any numeric expression giving the pixel coordinate to place the left hand side of the window. |
Y |
Required. Any numeric expression giving the pixel coordinate to place the top of the window. |
Comments: |
The pixel coordinates given are relative to the upper left hand corner of the screen if this is a non-child window. If this is a child window, then the coordinates are relative to the top left corner of the virtual client area of the parent window. This is consistent with the Window function. The corner being point (0, 0). The X coordinates increase as you move right across the screen. The Y coordinates increase as you move towards the bottom of the screen. Use with care in pages: your code will run when the page is displayed in the Idea Studio and when the Page Menu page shows a live preview, possibly with undesirable results in those situations. In a page, the trigger for this function should be a user action rather than anything that runs automatically. |
Example:
MoveWindow(CurrentWindow(), 20, 20);
This statement will cause the current window to move to the upper left corner of the screen. (Will not cause an error in script mode, but this is not common usage)