Element: window.move { }

Type

callback

Description

The command procedure to be executed when window changes position. This may happen as a result of a wmove command or via an interactive user operation.

When a move procedure is defined for a window and is invoked, the window identifier is passed to the procedure as its first parameter. To assist in handling the positional changes, two arrays are also passed providing the old and the new positions of the window. Both are 2-element numeric arrays. Note these are the positions of the top-left corner of the window frame surround (window.outrect).

The procedure is executed before the contents of the window are repainted. Move procedures should not include any commands which draw into the window.

Parameters

window.move(<window>,<old_dims>,<new_dims>)

Notes

window.move callbacks are only invoked for top-level windows.

New windows have a move procedure of null.

Example

win1.move = {
    args w=window, old=numeric[2], new=numeric[2]
    tell <'Window',w,'has been re-positioned';bell>
    tell <'Old position was',old>
    tell <'New position is',new>
}