top-level

Generic Function

Package: common-graphics

Arguments: window &key owner-p

In release 6.0 and later, use of this function is deprecated in favor of child-p (which returns the opposite of what this function returns, so replace calls to top-level with (null (child-p ...))). This function is maintained for backward compatibility.

Release 6.0 non-backward-compatible change: the stop-at-modal keyword argument has been removed. It in fact had no effect (since all modal dialogs are top-level window so this function always returned true for them).

Here is the pre-6.0 description of this function, somewhat edited:

If owner-p is nil, returns true if window is a top-level window and nil otherwise. A top-level window is one whose parent is the screen, though it may have an owner window. If owner-p is true, returns true if window has no owner window, and nil if it does have an owner window.

If stop-at-modal [starting in release 6.0, no longer accepted, this description kept for reference only] is true and window is a pop-up window, then true will always be returned; otherwise the return value is as described above.

See About child, parent, and owner windows in cgide.htm.

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.