nget-box

Arguments: window-or-screen old-box &optional scroll-p cursor first-corner

A destructive version of get-box. The old-box argument is modified to be the box chosen by the user and returned. Like get-box, this function waits for the user to press a mouse button down and then waits for the mouse button to be released. old-box is then modified to be the box that has two corners at the mouse cursor positions of the button press and the button release. old-box is then returned. Between the button press and the button release, a rubber-band box is drawn between the button press position and the current mouse cursor position.

window-or-screen should be a window or the screen. The screen is the value returned by (screen *system*). See screen and *system*.

If first-corner is true, it will be used for the button-down position rather than waiting for a button-down. In this case, either a button press or release will mark the second corner.

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).

Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page has had minimal revisions compared to the 6.1 page.
Created 2002.2.26.