owner

Generic Function

Package: common-graphics

Arguments: basic-pane

This function returns the owner of the argument if there is one. If the argument is a child window or a non-owned top-level window, this function returns its parent (which is a window for a child window or the screen for a non-owned top-level window).

Release 6.0 incompatibility note: in releases prior to 6.0, nil (instead of the parent) was returned when the argument was a child window or a non-owned top-level window. This change allows getting rid of the redundant function parent-or-owner, leaving only the functions parent and owner. It also brings owner into line with the meaning of the term "owner", which is "the window with which a specified window shrinks and closes", since the parent of a child window has that behavior in addition to the other parent behaviors.

Applications developed in release prior to 6.0 that call owner will probably typically be able to leaves the calls as they are. But if an application depends on owner to return nil for a child window, then it should substitute a form such as

(and (not (child-p window)) (owner window)) 

for the call to owner. And if an application depends on owner to return nil for a non-owned top-level window, then it should substitute a form such as

(and (windowp (owner window))(owner window))

Note that a so-called "non-owned top-level window" is now one whose owner is the screen rather than a window.

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.