Generic FunctionPackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.1
This page is new in 8.1. Moderate update since 8.1 release.

values-are-stacked

Arguments: chart-view

Returns the value of the values-are-stacked property of a chart-view. The value may be set at creation time by passing the values-are-stacked initarg, or any time later by calling (setf values-are-stacked).

A boolean value indicating whether the data values in a chart-view of a chart-widget are stacked to show cumulative values on the value-axis. The default value is nil.

This property is relevant only when the widget has multiple objects (see chart-objects), because otherwise there is nothing to stack.

For a bar-chart-view (when the chart-view of the chart-widget is :bar), a true value will stack the multiple bars of each chart item so that they lie end-to-end. A null value will place the bars side-by-side instead. The stacked option saves a lot of space, but can make it somewhat harder to compare the multiple chart objects. If bars are stacked and some values are above the base-value of the bar-chart-view while others are below, then all of the values that are above the base-value are stacked in one direction and all of the values that are below the base value are independently stacked in the other direction.

For a line-graph-view (when the chart-view of the chart-widget is :line), a true value will stack the data values so that the line for each chart object is relative to the lines of the chart objects below it. This is like a stacked area graph, though the areas between the lines are not filled. A null value will draw the lines independently of each other, which typically causes more crossing of the multiple lines.

In either case, the first object in the sequence of chart-objects is charted first, then the second object is stacked on the values of the first, and so on.

See chart-widget and also cg-chart-widget.htm.


Copyright (c) 1998-2009, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 8.1. This page is new in the 8.1 release.
Created 2007.4.30.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.1
This page is new in 8.1. Moderate update since 8.1 release.