TdxChartSecondaryAxisY Class

A secondary axis of values.

Declaration

TdxChartSecondaryAxisY = class(
    TdxChartCustomAxisY
)

Remarks

A secondary axis of values allows you to complement the main axis of values (Y-axis) with a different scale. For example, secondary axes can be useful if you need to display multiple measurement units simultaneously.

Note

The TdxChartSecondaryAxisY class implements secondary Y-axis functionality for the Chart control. To maintain a Y-axis collection, the control uses the TdxChartSecondaryAxisYCollectionItem class as a wrapper for a TdxChartSecondaryAxisY object.

Main API Members

The list below outlines key members of the TdxChartSecondaryAxisY class that allow you to configure an axis of values.

General

Assign: Copies compatible settings between chart axes.
Diagram: Provides access to the XY diagram to which the axis belongs.
Visible: Hides or displays the axis.

Appearance and Behavior

Alignment: Specifies the position of the secondary axis of values in relation to the orthogonal axis scale.
Appearance: Allows you to customize general appearance settings.
CrosshairLabels: Provides access to crosshair axis label settings.
MinorCount: Specifies the number of minor tick marks.
Ticks: Provides access to major and minor axis tick appearance settings.
Title: Specifies a title for the axis and changes title appearance and position.
ValueLabels: Allows you to display and customize axis value labels.

Tip
You can handle the parent diagram‘s OnGetAxisValueLabelDrawParameters event to customize individual axis value labels.

Gridlines: Allows you to display and customize axis grid lines in the parent diagram.
Interlaced: Applies interlacing to the parent diagram.
Logarithmic | LogarithmicBase: Allow you to enable a logarithmic scale for the numeric axis and adjust the scale’s logarithmic base.
NumericScaleOptions | Range: Adjust the numeric value range of the axis.
OnCompareValues: Allows you to implement a custom sorting algorithm for series points.
Reverse: Specifies if the axis direction is reversed.

Axis Deletion

To delete an individual secondary axis of values, release the corresponding wrapper object (a TdxChartSecondaryAxisYCollectionItem class instance) directly in code (call the Free procedure in Delphi or use the delete keyword in C++Builder).

Important

Do not release a TdxChartSecondaryAxisY object in code. Otherwise, an error can occur.

Direct TdxChartSecondaryAxisY Class Reference

The TdxChartSecondaryAxisCollectionItem.Axis property references a TdxChartSecondaryAxisY object.

Indirect TdxChartSecondaryAxisY Class Reference

The Chart control’s HitTest.Axis property references the TdxChartSecondaryAxisY class as a TdxChartCustomAxis object if the HitTest.HitCode property returns the TdxChartHitCode and the inspected point is within a secondary axis of values.