Function | Package: cg | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 9.0 Unrevised from 8.2 to 9.0. 8.2 version

## add-class-grid-row

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-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.2 page.
Created 2012.5.30.

|  | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 9.0 Unrevised from 8.2 to 9.0. 8.2 version