[Contents] [Index] [Help] [Retrace] [browse <] [Browse >]


NAME
    ChangeWindowBox -- Change window position and dimensions. (V36)

SYNOPSIS
    ChangeWindowBox( window, left, top, width, height )
                     A0      D0    D1   D2     D3

    VOID ChangeWindowBox( struct window *, word, word, word, word );

FUNCTION
    Makes simultaneous changes in window position and dimensions,
    in absolute (not relative) coordinates.

    Like movewindow() and sizewindow(), the effect of this function
    is deferred until the next input comes along.  Unlike these
    functions, ChangeWindowBox() specifies absolute window position
    and dimensions, not relative.  This makes for more reliable
    results considering that the action is deferred, so this
    function is typically preferable to movewindow() and sizewindow()
    paired.

    You can detect that this operation has completed by receiving
    the IDCMP_CHANGEWINDOW IDCMP message

    The dimensions are limited to legal range, but you should still
    take care to specify sensible inputs based on the window's dimension
    limits and the size of its screen.

    This function limits the position and dimensions to legal
    values.

INPUTS
    window = the window to change position/dimension
    Left, Top, Width, Height = new position and dimensions

RESULT
    Position and dimension are changed to your specification,
    or as close as possible.
    Returns nothing.

BUGS

SEE ALSO
    movewindow(), sizewindow(), zipwindow(),
    layers.library/movesizelayer()