TRSBubbleChartValue Class

Extends the FMX.RS.Charts.TRS2DImageChartValue class to provide the properties and methods needed to describe one bubble of the TRSBubbleChart component. The TRSBubbleChartValue class uses the
Size property to specify the size of the bubble. The size of the bubbles can represent the area of the bubbles or the diameter of the bubble (controlled by the
SizeOption property of FMX.RS.BubbleCharts.TRSBubbleChartValues ), which affects the relative size of one bubble to another.

Bubble sizes can be negative values, although negative bubbles do not display in the chart by default (
NegativeSizeVisible must be true). When negative bubble sizes are displayed, they use their absolute size and are always drawn using the
NegativeSizeColor.

Important Note

Note that for drawing purposes, the bubble size is proportional to the greatest bubble size in the collection of bubbles. Only the largest bubble is drawn with its correct diameter or area.

Specifies the TRSBubbleChartValues instance to which this Item belongs. Each TRSBubbleChartValue belongs to the TRSBubbleChartValues collection which creates it. The Collection property points to the collection object to which the value belongs.

Specifies the color of this individual value, e.g., the color of the bar or the point or the shape. When coColorEachPoint is in the FMX.RS.ChartPanel.TRSCustomChart.Options property, this color is drawn by the chart. When coColorEachPoint is not in the the Options property, the Color of the chart is used. (Inherited from FMX.RS.ChartPanel.TRSChartValue.)

Specifies the scale factor for the value. A scale factor of 1 (default) draws the value at its normal size within the chart. Change the scale factor to shrink or grow the value within the chart (for drawing purposes only) (Inherited from FMX.RS.ChartPanel.TRSChartValue.)

Determines whether the chart value is selected. Use the Selected property to select or deselect a chart value. Selected chart values are displayed with the SelectionColor of the chart panel.
(Inherited from FMX.RS.ChartPanel.TRSChartValue.)

Returns the size of the bubble as a diameter or an area. The size of the bubbles can represent the area of the bubbles or the diameter of the bubble (controlled by the SizeOption property of TRSBubbleChartValues), which affects the relative size of one bubble to another.

Bubble sizes can be negative values, although negative bubbles do not display in the chart by default ( NegativeSizeVisible must be true). When negative bubble sizes are displayed, they use their absolute size and are always drawn using the NegativeSizeColor.

Important Note

Note that for drawing purposes, the bubble size is proportional to the greatest bubble size in the collection of bubbles. Only the largest bubble is drawn with its correct diameter or area.

Returns the main (or only) dimension in a chart value - which dimension is returned is based on the chart type. A chart value, depending on the chart type, can contain 1 or more dimensional values that define the chart value.

For example, each chart value in a bar chart contains 1 value (defining the height of the bar), line chart values contains 2 dimensions: X and Y, and shape chart values contain 4 dimensions: X, Y, Width, and Height. The ValueCount property returns the number of dimensions in the chart value. Use the Values property to access each dimension in the chart value (Note that TRSChartValue descendant classes expose properties, such as X and Y, which are safer to access the specific dimension of the value. You should not count on a specific dimension index to contain a specific property).

Use the Values property to access each dimension in the chart value. The Value property in comparison returns the main (or only) dimension in a chart value - which dimension is returned is based on the chart type.

Caution

Note that TRSChartValue descendant classes expose properties, such as X and Y, which are safer to access the specific dimension of the value. You should not count on a specific dimension index to contain a specific property

Use the Values property to access each dimension in the chart value. The Value property in comparison returns the main (or only) dimension in a chart value - which dimension is returned is based on the chart type.

Caution

Note that TRSChartValue descendant classes expose properties, such as X and Y, which are safer to access the specific dimension of the value. You should not count on a specific dimension index to contain a specific property

Determines whether the chart value is visible or not. Use the Visible property to change the visibility of the chart value. Even if the Visible property is True, the chart value may still not be visible if the chart axis is zoomed. (Inherited from FMX.RS.ChartPanel.TRSChartValue.)

Provide access to the third dimension of the Values property formatted as a TDateTime. The XAsDateTime, YAsDateTime, and ZAsDateTime properties provide access to the first three dimensions of the Values property formatted as a TDateTime

Notes to Inheritors

These properties have protected visibility in the class, but descendant classes (e.g., RSCharts|TRS2DChartValue and TRS3DChartvalue ) publish the properties to provide more explanatory access to the dimensions of the Values property.

Provide access to the third dimension of the Values property. The X, Y, and Z properties provide access to the first three dimensions of the Values property.

Use the X, Y, and Z property to access the coordinates of a point.

Notes to Inheritors

These properties have protected visibility in the class, but descendant classes (e.g., RSCharts|TRS2DChartValue and TRS3DChartvalue ) publish the properties to provide more explanatory access to the dimensions of the Values property.

Overloaded. Returns True if the Value should be selected. This depends on the Selected state and if the value rectangle intersects with the selection rectangle. (Inherited from FMX.RS.ChartPanel.TRSChartValue.)

Returns a comma-delimited string of the floating-point values of the Value. The Fmt property specifies how to format the floating-point values (see FormatFloat function from Delphi's help). The Parentheses property controls if parentheses are put around the comma-delimited string. (Inherited from FMX.RS.ChartPanel.TRSChartValue.)