name

Generic Function

Package: common-graphics

Arguments: standard-object

Returns the value of the name property of the argument. The object may be any Common Graphics object that has a name property. Objects may be found from their names by passing the names to various finder functions, such as:

The name should be a symbol, so that finder functions can find the object by using eq tests on the name. To ensure that the finder functions find the expected objects, any objects that co-exist within some context that is passed to a finder function (such as the parent window passed to find-component) should always be given mutually unique names (and so any two components on the same parent window should never have the same name, for example). If the finder-function has no context (such as find-timer), then the names should be globally unique among objects of that type (such as all timers).

When an object that has a name property is created without specifying a :name initarg value, a default name is assigned. In particular, when placing components onto form windows in the IDE, mutually unique default names are assigned by appending sequential numbers to the name of the class of each component (resulting in names such as :picture-button-1 followed by :picture-button-2).

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.