| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: class-grid data-object &key index scroll-into-view focus-on-row
Adds a single object to the list of objects that a class-grid
is displaying. An
alternative is to replace the whole set of displayed objects by
calling (setf
value) on the grid, passing a list of all objects to display.
Internally this creates a class-grid-body-row
and adds it to the body
row-section of the grid-widget
.
class-grid is the class-grid
to which an object will be added.
data-object is the new object to display.
It should be an instance of the edited-class of the class-grid
.
index specifies the position of the new
grid-row
among the existing
rows. It may be either an integer index, where zero means to add the
row at the very top, or else nil
to add the
row at the very bottom. The default is nil
.
If scroll-into-view is true, then the body
row-section will be
scrolled as needed to make the new row fully visible. If nil
, then this is not done. The default is nil
.
If focus-on-row is true, then the keyboard
focus within the grid will be moved to a cell of the new row. If
nil
, then this is not done. The default is
nil
. A true value still does not move the
keyboard focus to the class-grid itself, but when
it is next moved there the focus will be in the new row. An
application could call set-focus-component to move the focus to the
class-grid to allow the user to immediately edit
the new row.
Modifying the list of instances that a class-grid
displays will call the grid's on-change function because the list of
instances is stored as the value property of the widget.
See also delete-class-grid-row.
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.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |