x-axis

Arguments: plot-widget

This functionality was added in an update released in the Fall of 2008. You must have that update to use this functionality. See sys:update-allegro for information on getting updates.

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

The x-axis of a plot-widget is the primary horizontal axis of the widget, and always lies along the bottom side of the plot. If a secondary horizontal axis is desired along the top side of a plot, then use the x-axis-2 property for that.

The value of the x-axis property should be an instance of the plot-value-axis class, and holds properties that determine how the axis is drawn and the range of values that it displays. The properties are inherited from the value-axis and chart-axis classes.

The value of this property will always be a plot-value-axis instance. If you do not pass a plot-value-axis instance as the value of the x-axis initarg when creating a plot-widget, then a default instance is created automatically.

If there are multiple chart objects (see chart-objects), then some of the objects may use this axis for their x coordinates while others use the x-axis-2 axis.

See also x-axis-2, y-axis, y-axis-2, and plot-widget.

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.