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

set-chart-value

Arguments: chart-widget &key item-index object-index item-id object-id value from-value low-value high-value icon-size update-now

Establishes one or more of the values to display on a chart-widget for a single pairing of a chart item and a chart object. The return value is not defined.

(For example, if a line graph has a line for each bowler on a team, and a bowling score for each week, then each bowler is represented by a chart object while each week is represented by a chart item.)

An alternative to calling set-chart-value multiple times is to provide a chart-value-returner function that will be called as needed to return all of the chart's values. That approach is more efficient if you already have all of the chart's data stored somewhere such as in an array. The set-chart-value approach is somewhat more straightforward, and is more suitable if you are incrementally adding or modifying the data over time.

chart-widget is the widget to modify.

The keyword arguments

The first group of keyword arguments specify which chart item/object pair to modify.

The next group of keyword arguments specify one or more values for the specified item/object pair. Any subset of these arguments may be passed, though the auxilliary values will have no effect until if and when the main value is specified for the same item/object pair. A value must always be either a real number to add a value to the chart, or else nil to remove a value from the chart. Existing values can be modified by respecifying them in further calls to set-chart-value.

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.