section-count

Generic Function

Package: common-graphics

Arguments: grid-subsection

Returns or sets with setf the value of the section-count property of the argument. This property determines the number of times that the grid-row or grid-column will be replicated. A replicated row or column will appear as multiple rows or columns, except that the format (size, font, etc.) is always the same for the whole set. And the whole set shares the same data-object (for rows) and data-reader (for columns) and so on. Some grid functions take row-number and column-number arguments, which identify the particular replication of the row or column object. A section-count of 1 indicates a "regular" non-replicated row or column. This is the default.

A replicated row or column may be useful when displaying a set of items that should look and behave exactly the same on a grid. For example, in the employee grid example the bar-chart section that displays a bar for each of the twelve months of the year is implemented as a single replicated grid-column with a count of 12. Internally, the 12 values are kept in a single list, and the column-number that is passed to various methods is used to reference a particular column's index within the list.

section-count is a property of the grid-subsection, grid-column, row-header-column, grid-row, and column-header-row classes.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.