find-window

Returns the window whose name is name and whose
parent or owner is parent-or-owner (which can be
nil if there is no such window). The default
value of parent-or-owner is the screen, and so
this argument need not be passed in order to find any top-level window
(since the parent of a top-level window is always the screen). The
screen is the value returned by (screen
*system*). See screen and *system*.

window-name
should be the symbol that was passed as the value of the
name initarg to make-window (or passed to (setf name)
to rename the window later). The
parent-or-owner should either be the
window or screen that was passed as the value of the
owner argument to make-window, or alternately the
screen in the case of an owned top-level window (whose owner is
another window but whose parent is the screen).

If owned-p is nil
(the default), then only child windows of
parent-or-owner are searched. If true, then only
non-child owned windows of parent-or-owner are
searched. A true owned-p argument is useful only
when parent-or-owner is a top-level window or the
screen, because child windows cannot have non-child owned windows. (A
non-child owned window is created by passing the
child-p initarg of make-window as nil,
along with a top-level window for the owner
argument.)

A more general function for finding objects from their names and
ancestor objects is find-named-object.

Compatibility note: Prior to version 8.1, there was no
owned-p argument and both child windows and
non-child owned windows were always both searched. This incompatible
change was made for efficiency reasons. If an application calls
find-window to find a
non-child owned window of a top-level window, it should now pass the
new owned-p argument as true.

Copyright (c) 1998-2009, Franz Inc. Oakland, CA., USA. All rights reserved.Documentation for Allegro CL version 8.1. The object described on this page has been modified in the 8.1 release; see the Release Notes.Created 2007.4.30.