plot-values

Arguments: plot-widget

Returns the value of the plot-values property of a plot-widget. The value may be set at creation time by passing a plot-values initarg to make-instance, or any time later by calling (setf plot-values).

This property contains a set of values that are displayed in a plot-widget. This tree is normally built indirectly by successive calls to set-plot-value. Values are looked up here when the plot is being drawn, or when an application calls plot-value.

An application normally does not need to access this property directly, though it could build the value itself and call (setf plot-values) to set all of the plot's values at once. Here is an example of a form that would return a valid plot-values value:

(vector (vector (list :x 2 :y 3) (list :y 4 :x 9 :y-low 4.2)
                (list :x 3 :y 6.5 :icon-size 6)
                (list :x 1.3 :y 6.5 :x-low 1.1 :x-high 1.6)
                (list :x 1.3 :y 7.5) (list :x 1.3 :y 8.5)
                (list :x 3.3 :y 8.5) (list :x 12 :y 3))
        (vector (list :x 4.3 :y 8.5) (list :x 5.3 :y 8.5)
                (list :x 6.3 :y 6.5) (list :x 6.3 :y 4)))

The value is a vector where each element of the vector represents one chart object (see chart-objects). Each chart object element is itself a vector of points that will be plotted for that object. Each point is a property list whose keys can be any of the valid values for the value-type argument to set-plot-value.

To avoid building this vector of values at all, use a plot-value-returner function instead.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.