Generic Function | Package: cg | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 10.1 Unrevised from 10.0 to 10.1. 10.0 version

## name

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:

- find-window
- find-component
- find-sibling
- find-pixmap
- find-cursor
- find-timer
- find-item
- find-outline-item
- find-tab
- find-column
- find-project
- find-module
- find-property
- find-application-window
- find-named-object

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`).

Copyright (c) 1998-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.

|  | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 10.1 Unrevised from 10.0 to 10.1. 10.0 version