nget-fixed-box

Generic Function

Package: common-graphics

Arguments: stream old-box &optional scroll-p cursor

A destructive version of get-fixed-box. The old-box argument is modified to be the box chosen by the user and returned. Like get-fixed-box, this function waits for the user to press or unpress a mouse button after moving the mouse about. Rubber band boxes are drawn continuously to follow mouse movement during the wait, beginning at old-box. The user is only choosing the box location. The width and height of the box remains the same. Old-box is then modified to be the box at the button event. Old-box is then returned.

If scroll-p is true, the window identified by stream will be scrolled if the cursor moves outside it. Sets the stream cursor to cursor while running. If the cursor argument is t, a stream default is used (typically the cross-hair cursor).

Note: incompatible change in release 6.0: in releases prior to 6.0, when a frame-with-single-child instance was passed to this operator, the operator was actually applied to the child (the result of applying frame-child to the frame-with-single-child instance). In release 6.0, this redirection no longer occurs. If you intend this operator to apply to the frame-child, pass that to this operator rather than the parent. This is a non-backward-compatible-change. See the release notes for more information.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.