Extends the RSChartPanel.TRSChartGraphic class to provide the properties and behavior of a chart axis for a RSChartPanel.TRSCustomChartPanel component. The TRSChartAxis class is responsible for managing the display of an axis (e.g., grid lines, labels, title) and for managing the range of chart values on an axis and converting between axis values and pixel values.
The TRSCustomChartPanel component uses the TRSChartAxis class for its four axes: BottomAxis, LeftAxis, RightAxis, and TopAxis. A RSChartPanel.TRSCustomChart component also keeps a reference to the horizontal and vertical axis that apply to its chart values (see HorizontalAxis and VerticalAxis properties).
The most important properties of the chart axis class are the Minimum and Maximum properties, which specify the range of the axis, and the ZoomMinimum and ZoomMaximum properties, which specify the zoomed range (e.g., visible range) of the axis. The Options property controls the display of the axis and well as controlling whether the axis automatically updates its Minimum and Maximum range values based on the Charts, and their values, assigned to the axis.
The most important methods of the axis are the
AxisToPixel and
PixelToAxis methods, which are responsible for converting between the actual values of the axis and their location on a Canvas.
Namespace: RSChartPanel
TPersistent |
Delphi |
type |
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Represents property Dimension. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
The StartPosition and EndPosition properties specify the end points of the axis, in percentage of the normal axis length. The StartPosition is usually 0%, meaning that, for the BottomAxis for example, the left end of the axis is all the way to the left, aligned against the LeftAxis. The EndPosition is usually 100%, meaning that the BottomAxis' right end is all the way to the right, aligned against with the RightAxis. Specify a value greater than 0 for the StartPosition or less than 100 for the EndPosition to move the end points in and shorten the length of the axis. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Sspecifies the format of the chart values when the axis represents floating point values. If the axis represents date time values, the DateTimeFormat property specifies the format of the chart values. The two format properties are used by the FormatValue method to return the proper string representation of a chart value. Use the IsDateTime method to determine if the axis is displaying date time values. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defines the properties of the axis grid: tick marks, major and minor grid marks, and drawing pens. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Returns the height (in pixels) of the chart axis. The Height and Width of the axis is calculated by the CalculateBounds method (or every time the axis draws). |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Controls where the chart axis paints within the chart grid. InwardPosition specifies the distance as a percentage from the edge where the axis would normally paint (left, top, right, bottom) towards the middle of the chart drawing area. If InwardPosition is greater than 0, the chart axis is moved in toward the center, 50% would be the center of the rectangle. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Represents property IsDrawing. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defines the amount to increment the value for the Labels between each label. When LabelIncrement is 0, the TRSChartAxis calculates the increment for the labels by trying to use MinSpacing and then growing as needed. Set LabelIncrement to a non-zero value to define the amount yourself |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defines the properties of the chart axis labels, including Font , Alignment, and Angle. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defines the style of the chart axes' labels, e.g., whether the labels are numeric or RSChartPanel.TRSChartValue Captions. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Specifies the location (left, right, top, bottom) of the chart axis in the RSChartPanel.TRSChartPanel |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defines the logarithmic equation type to apply to the chart axis |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defines the log base for when the axis is displaying a grid using the logarithmic Options . |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defines whether the axis should cycle (start over) as it draws a logarithmic grid. If LogCycle is false, one cycle covers the entire axis range. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Specifies the maximum value for the range of the axis. The Minimum and Maximum properties specify the full range of the axis, regardless of whether the axis is zoomed or not. The ZoomMinimum and ZoomMaximum properties return the zoomed range of the axis - when the axis is not zoomed, these properties equal the minimum and maximum properties. Use the Maximum property to set the full maximum range of the axis. Alternatively, you can include axAutomaticMaximum in the Options property and the axis will automatically calculate the maximum value based on the chart values ( RSChartPanel.TRSChartValues class). Setting the Maximum property manually causes the axis to remove the axAutomaticMaximum member from the Options set. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Represents property MaxLabelWidth. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Specifies the minimum value for the range of the axis. The Minimum and Maximum properties specify the full range of the axis, regardless of whether the axis is zoomed or not. The ZoomMinimum and ZoomMaximum properties return the zoomed range of the axis - when the axis is not zoomed, these properties equal the minimum and maximum properties. Use the Minimum property to set the full mnimum range of the axis. Alternatively, you can include axAutomaticMinimum in the Options property and the axis will automatically calculate the minimum value based on the chart values ( RSChartPanel.TRSChartValues class). Setting the Minimum property manually causes the axis to remove the axAutomaticMinimum member from the Options set. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Specifies the minimum separation between labels in percent of axis size. This property controls how close together the labels will appear on the axis. This property is obviously closely tied to the Labels property as such things as Font and Angle can affect how many labels can be squeezed into an axis. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Specifies the minimum amount, in chart axis values, that the major grid marks and their labels should use. This value is usually 0 to let the chart axis choose the stepping increment. For example, if the chart axis would choose an increment of 10, e.g., 0, 10, 20, 30, etc, for the major grid, by setting this property to 25 you would force the stepping increment to be 0, 25, 50, etc. Note that setting this property to 5 would have no effect on the stepping increment in the above case. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Represents property NeedAxisUpdate. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Occurs immediately after the chart graphic object changes. Write an OnChange event handler to take specific action when the chart graphic changes. The properties of the chart graphic reflect the new settings when OnChange occurs.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Represents property Opacity. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defines the set of display and computation options for the chart axis. This property allows you to make the chart axis calculate the Minimum and Maximum values automatically, display labels and titles, and other options. Please see RSChartConsts|TAxisOption for more information. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Returns the RSChartPanel.TRSCustomChartPanel instance that owns the chart axis. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Represents property Pen. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Controls whether the grid (and labels) should "snap" to the evenly divisibles of the Spacing (e.g., instead of 13, 23, 33, it would be 10, 20, 30) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
The StartPosition and EndPosition properties specify the end points of the axis, in percentage of the normal axis length. The StartPosition is usually 0%, meaning that, for the BottomAxis for example, the left end of the axis is all the way to the left, aligned against the LeftAxis. The EndPosition is usually 100%, meaning that the BottomAxis' right end is all the way to the right, aligned against with the RightAxis. Specify a value greater than 0 for the StartPosition or less than 100 for the EndPosition to move the end points in and shorten the length of the axis. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defines the label and display properties of the chart axis Title. The title is the caption that describes what the axis' value labels mean, e.g., 'Temperature (C)' is a title for an axis that has values running from 0 to 100 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defines the amount in pixels between the axis Title and the rest of the axis. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Represents property Visible. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Returns the width (in pixels) of the chart axis. The Height and Width of the axis is calculated by the CalculateBounds method (or every time the axis draws). |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Indicates if the chart axis is zoomed in or not, (e.g., ZoomMinimum = Minimum and ZoomMaximum = Maximum). |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
The ZoomMaximum and ZoomMinimum properties allow you to programmatically zoom the chart axis to a portion of the Maximum - Minimum range. It allows you to change the portion of the axis that is being visually displayed. If the chart axis is not being zoomed, then these properties will equal the chart axis range (and Zooming return False). Use ZoomMaximum and ZoomMinimum to zoom the chart axis or use the Zoom method. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
The ZoomMaximum and ZoomMinimum properties allow you to programmatically zoom the chart axis to a portion of the Maximum - Minimum range. It allows you to change the portion of the axis that is being visually displayed. If the chart axis is not being zoomed, then these properties will equal the chart axis range (and Zooming return False). Use ZoomMaximum and ZoomMinimum to zoom the chart axis or use the Zoom method. |
|
|