edited-instances

Arguments: object-editor

Returns a list of the particular instances that an object-editor dialog is editing, or nil if the object-editor is editing all instances of a persistent class. The value may be set with the edited-instances initarg at creation time, or any time later by calling (setf edited-instances). The default value is nil. If this property is never set, then the dialog will attempt to edit all instances of its edited-class, though this requires that the class be a persistent (AllegroCache) class so that all instances can be found.

At this time, editing a huge number of instances may be unwieldy because an object-editor always sorts the instances (typically according to the primary-name-slot of the class if any), which entails loading every instance from a database (if the instances are coming from a database). This is done to facilitate browsing the instances in an intuitive order, and for the object-editor-select facility to be able to present many instances as a series of alphabetized pop-up menus. And the object-editor-search facility needs to load every instance in order to search one or more of its slots. Options may be added in the future to facilitate handling large databases better.

For the related class-grid widget, the value property is used instead of an edited-instances property to store the list of instances, and a value of nil will display no instances rather than all of them.

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.