section-count

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.

Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page was not revised from the 6.1 page.
Created 2002.2.26.