find-named-object

Arguments: name scope

Returns an object whose name is name and for which scope is some ancestor of the object, or nil if no such object is found. By "ancestor", we mean either the parent or owner of the object, or an ancestor of the parent or owner. In addition, if the name argument is the name of the scope object itself, then that object is returned. name is generally the symbol that was passed as the value of the name initarg when creating the object.

The object to be found and the ancestor that defines the scope of the search may be either:

• a window and an ancestor window or screen,
• a dialog-item and an ancestor window or screen,
• a menu and an ancestor menu,
• a menu-item and an ancestor menu,
• any of those objects and a list of possible ancestors.

The screen is the value returned by (screen *system*). See screen and *system*.

If this function is used, it may be necessary to use unique names across all windows, dialog-items, menus, and menu-items in your application. If more specific finder functions are used instead, then it is necessary to use unique names only among the siblings that share a particular parent or owner object. The more specific finder functions include:

• find-window
• find-application-window
• find-component
• find-sibling
• find-item
• find-outline-item
• find-column
• find-tab

(There is only a partial overlap between the kinds of objects that these functions find and the ones found by find-named-object.)

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.