get-screen-box

Function

Package: common-graphics

Arguments: &key prompt title no-dialog

Waits for the user to specify two corner positions on the screen, and returns a box made from those positions. To allow the specification of any screen positions without affecting whatever windows are at those positions (as might happen with a mouse click), the user must specify each position by placing the mouse cursor at the desired position and then pressing the control key. If no-dialog is nil then a modal dialog first appears to explain the specification procedure to the user; if no-dialog is true then the dialog is skipped. If prompt is nil, then a general explanation appears in the dialog; otherwise prompt should be a similar string that may be customized to the particular application. title is either a string to serve as the title of the modal dialog or nil (the default) for no title.

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.