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


Arguments: chart-axis

Returns the marker-lines property of a chart-axis object, which is associated with a chart-widget or plot-widget control. The value may be set at creation time by passing the :marker-lines initarg to make-instance, or any time later by calling (setf marker-lines).

Marker lines are straight line segments or thicker bands that are drawn perpendicular to a chart axis. Each line or band is drawn outward from a specified value (for a line) or range of values (for a band) along the axis, to highlight an arbitrary set of values.

An example would be a chart of economic statistics, where the item-axis represents time and has bands extending from it to mark where recessions have occurred in the past.

There are no entries in the chart legend for marker-lines. Their meaning could be noted in the subtitle or footnote text of a chart.

The value of the property should be a list of lists, where each sublist is a property list that describes one line or band to draw perpendicular to the axis. Here are the valid keys for each property list, and the type of value to specify for each one:

Here is a sample value of the marker-lines property of an axis that would draw two lines and two bands:

((:value 3.5 :color blue :line-width 5 :line-dashing :dot)
 (:value 6)
 (:value 7 :value-to 8.5)
 (:value 10.4 :value-to 15 :color cyan))

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