| Allegro CL version 9.0 Unrevised from 8.2 to 9.0. 8.2 version |
A class-grid
is a
specialized grid-widget
subclass that makes it easier to create grids that edit instances of
classes. Rather than defining row and column classes and then
instantiating those classes and adding them to a grid-widget, you
instead specify a single expression that parametrically describes the
slots to be edited, and then the class-grid will automatically create
grid columns for those slots. It will also automatically create grid
rows for a set of instances when you set its value property to be a
list of instances.
A class-grid always has a single body section with other sections for column and row headers, and there are other limitations to the style of the grid. In exchange for those limitations, a class-grid is much easier to set up than a general grid-widget.
To use a class-grid
, there
are three main properties that you need to set:
grid-column
for each specified slot, and is the
biggest step in creating a class-grid. See edited-slots for a full description of the
format of this value. If a class-grid is on a form window in an IDE
Project, then you can specify this large value interactively by using
the IDE's Class Interface Editor dialog.
grid-row
for each
instance. Alternately you can call add-class-grid-row to add each row individually.
Changing the list of instances in the value property in either of these ways will also
cause the widget's on-change
function to be run for user side effects.
A class-grid
has all of the
properties of a grid-widget
, but you shouldn't set the
column-sections and
row-sections properties
because they are created automatically from the edited-slots property. Since you cannot specify
properties of a class-grid's sections and subsections directly at
creation time, some high-level properties are defined on the
class-grid class itself that will affect its subobjects. These
properties include:
For advanced use, after a class-grid
has been created you could find the
automatically created column and row sections and their subsections
and modify them as with any other grid-widget
. To do so, you may want to know
that the two column-sections are named :header
and
:body
(in that order), and so are the two
row-sections. The single subsection of each header section is also
named :header
. The name of each column in the body
is the name of the slot that it edits.
Copyright (c) 1998-2012, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 9.0. This page was not revised from the 8.2 page.
Created 2012.5.30.
| Allegro CL version 9.0 Unrevised from 8.2 to 9.0. 8.2 version |