Skip to main content

TdxChartRange.WholeMax Property

Specifies the maximum argument or value on a scale, depending on the current axis.

Declaration

property WholeMax: Variant read; write;

Property Value

Type Description
Variant

The maximum available argument or value on a scale, depending on the current axis.

Remarks

Range.WholeMin and Range.WholeMax property values of the axis of arguments (X-Axis) and the axis of values (Y-Axis) define the base available diagram area. If Range.WholeMin and Range.WholeMax properties are unspecified, the base diagram area is defined by the absolute minimum and maximum arguments and values among all series in the diagram.

VCL Chart Control: The Base Diagram Area

The Base Diagram Area and Side Margins

Range.ActualSideMarginMin and Range.ActualSideMarginMax property values of X and Y axes extend the available XY diagram area beyond the minimum and maximum available arguments and values.

VCL Chart Control: The Base Diagram Area and Side Margins

Examples: Resize the Available Diagram Area

You can use Range.WholeMin and Range.WholeMax properties of the axis of arguments or the axis of values to shrink or extend the visible (or scrollable, if the diagram is zoomed) diagram area along the corresponding axis.

The Axis of Arguments

WholeMin Value WholeMax Value Example[1]
Unspecified (equivalent to -3)[2] Unspecified (equivalent to 5)[2] VCL Chart Control: The Default Scale Along the Axis of Arguments
-2[3] 3[3] VCL Chart Control: A Limited Scale Along the Axis of Arguments
-5[4] 6[4] VCL Chart Control: An Extended Scale Along the Axis of Arguments

The Axis of Values

WholeMin Value WholeMax Value Example[5]
Unspecified (equivalent to -4)[6] Unspecified (equivalent to 5)[6] VCL Chart Control: The Default Scale Along the Axis of Values
-2[7] 3[7] VCL Chart Control: A Limited Scale Along the Axis of Values
-5[8] 7[8] VCL Chart Control: An Extended Scale Along the Axis of Values

Default Value

The WholeMax property has no default value. If the WholeMax property is unspecified, the maximum base scale value matches the absolute maximum argument or value (depending on the current axis) among all series in the diagram.

Footnotes
  1. This example demonstrates different WholeMin and WholeMax property values for the axis of arguments of the same XY diagram. Refer to individual example footnotes for details.

  2. Unspecified WholeMin and WholeMax properties define the scale of the axis of arguments within the range between the absolute minimum and maximum series arguments on the diagram.

  3. The scale of the axis of arguments is limited. The remaining diagram area is stretched along the axis of arguments to fit the current Chart control area by width.

  4. The scale of the axis of arguments is extended beyond the absolute minimum and maximum series arguments on the diagram. The resulting diagram area is shrunk along the axis of arguments to fit the current Chart control area by width.

  5. This example demonstrates different WholeMin and WholeMax property values for the axis of values of the same XY diagram. Refer to individual example footnotes for details.

  6. Unspecified WholeMin and WholeMax properties define the scale of the axis of values within the range between the absolute minimum and maximum series values on the diagram.

  7. The scale of the axis of values is limited. The remaining diagram area is stretched along the axis of values to fit the current Chart control area by height.

  8. The scale of the axis of values is extended beyond the absolute minimum and maximum series values on the diagram. The resulting diagram area is shrunk along the axis of values to fit the current Chart control area by height.

See Also