uncache-instances-with-pretty-names

Arguments: class-or-class-name

This function may be used to clear a cache that is used by class-grid widgets and object-editor dialogs if programmatic changes may have made the cache out-of-date.

class-grids and object-editors cache a list of the instances that they display, along with the pretty names that are used to present the instances to the end user. This is done to avoid consing the pretty names when the instances are sorted by the pretty names or presented in menus and so on. As long as the instances are modified only by the end user via class-grids and object-editors, the cached pretty names are kept up-to-date. But if an application uses some other means to modify the instances so that their pretty names may no longer be up-to-date, then it can call this function to clear the cache for one or all classes. For example, if the primary-name-slot of the "person" class is last-name, and the application programmatically changes the value of that slot for one or more person instances, then it should call this function on the person class.

class-or-class-name may be either a class object or the name of a class. It can also be the keyword :all to clear the entire cache of pretty names for all classes.

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.