Generic FunctionPackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 10.1
Unrevised from 10.0 to 10.1.
10.0 version


Arguments: plot-widget

The value of this property can be a function (or the name of a function) that supplies the data values to be displayed in a plot-widget. Otherwise it should be nil (the default), in which case the plot's data must be supplied by calling set-plot-value multiple times. plot-widget must be a plot-widget.

The function will be called automatically every time the plot-widget draws a value. The arguments to the function indicate which plot value index and object it is drawing, and which type of value. The function should return a number to display, or else nil if that type of value should not be drawn for the specified object and value index.

Generally when using a plot-value-returner you should also specify the plot-values-max-index property of the plot-widget, and maybe also the plot-values-min-index property, to tell the plot the range of value indexes that it should pass to the function. And if the plot contains more than one object, then you should also set up the chart-objects property to tell the plot the range of object indexes that it should pass to the function (and typically their object IDs as well).

Note that in the inspector this property is on the Events tab because its value is a function, though it is not actually handling window system events.

See the page for the plot-widget class for an example of a plot-value-returner function.

The parameter list of a plot-value-returner function should be this:

Arguments: plot-widget value-type value-index object-index object-id

These arguments are:

Copyright (c) 1998-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.

Allegro CL version 10.1
Unrevised from 10.0 to 10.1.
10.0 version