The TRSChartInChart component is a FMX.RS.Charts.TRSCustomShapeChart descendant where every value represents a chart inside a chart (similar to Picture-in-picture). The chart-in-chart displays chart values ( FMX.RS.Charts.TRSChartInChartValue) as charts where each point can be its own chart (e.g., the point can be a pie chart, a bar chart, etc). Each point has its own shape and size as well as sub-chart. Only one-subchart per value is allowed, though multiple values are permitted.
Important Note |
---|
The TRSChartInChart component will take care of freeing any sub-charts unless the subchart has an Owner. |
Note |
---|
Charts are TGraphicControl descendants for VCL and TControl descendants for FMX. Display charts on a chart panel (with integrated axes, legend, header, footers, etc) or stand-alone (allowing use of FMX effects or embedding within other controls). Set the Panel property to the FMX.RS.ChartPanel.TRSChartPanel you want the chart displayed inside or nil for stand-alone use. |
Namespace: FMX.RS.Charts
TControl |
Delphi |
type |
|
|
(Inherited from FMX.RS.ChartPanel.TRSCustomChart.) |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Draw(TCanvas,TCanvasRect,TRSChartAxis,TRSChartAxis,Boolean,Boolean) |
Overloaded. Paints the chart to the specified Canvas in the specified location. The Draw Method uses the supplied TRSChartAxis (instead of the HorizontalAxis and VerticalAxis properties) to convert the chart values into pixel coordinates. Unlike the regular Draw method, this method draws the axes as well (useful for when the chart is not connected to a panel). Use the Draw method to paint the chart to any canvas and anywhere and with any size on the canvas. |
(Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
DrawArea(TCanvas,TRS2DChartValue,TCanvasRect,TCanvasPixel,TCanvasPixel,Boolean)
Draws the area under the line for that line segment (Inherited from FMX.RS.Charts.TRSCustomLineChart.)
DrawAxes(TCanvas,TCanvasRect,TRSChartAxis,TRSChartAxis)
Draws the specified axes to the Canvas (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
DrawGlyph(TCanvas,TCanvasRect)
Overloaded. Represents method DrawGlyph(TCanvas,TCanvasRect). (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
DrawGlyph(TCanvas,TRSChartValue,TCanvasRect)
Represents method DrawGlyph(TCanvas,TRSChartValue,TCanvasRect). (Overrides FMX.RS.Charts.TRSCustomShapeChart.DrawGlyph(TCanvas,TRSChartValue,TCanvasRect).)
Calls the OnDrawing event and returns True if the draw process should continue.
This method is called before the InternalDraw method.
DrawLabel(TCanvas,String,TCanvasPixel,TCanvasPixel,Single)
Overloaded. Draws the text caption centered above the X, Y point without clipping.
Note |
---|
The Opacity is ignored in VCL |
DrawLabel(TCanvas,String,TCanvasRect,Single)
Overloaded. Draws the text caption centered within the rectangle. The text is clipped
Note |
---|
The Opacity is ignored in VCL |
DrawLabel(TCanvas,TRSChartValue,TCanvasPixel,TCanvasPixel)
Overloaded. Draws the text caption centered above the X, Y point without clipping.
Note |
---|
The Opacity is specified by the FMX.RS.ChartPanel.TRSChartValue.Opacity property |
DrawLabel(TCanvas,TRSChartValue,TCanvasRect)
Draws a label for the TRSChartValue on the canvas. The text of the label is controlled by the ValueLabelStyle property.
The label is drawn within the specified rectangle.
Note |
---|
The Opacity is specified by the FMX.RS.ChartPanel.TRSChartValue.Opacity property |
DrawLine(TCanvas,TCanvasRect,Boolean)
Overloaded. Draws the entire line for the chart. The method calls other methods depending on the LineStyle. (Inherited from FMX.RS.Charts.TRSCustomLineChart.)
DrawLine(TCanvas,TRS2DChartValue,TCanvasRect,TCanvasPixel,TCanvasPixel,Boolean)
Overloaded. Draws the line for the line segment (from last point value to this point value) (Inherited from FMX.RS.Charts.TRSCustomLineChart.)
Calls the OnDraw event.
This method is called after the InternalDraw method.
DrawPoint(TCanvas,TCanvasRect,TRSPointChartValue)
Draws one point at the specified rectangle (Inherited from FMX.RS.Charts.TRSCustomPointChart.)
DrawShape(TCanvas,TCanvasRect,TRSShapeChartValue)
Draws one shape at the specified rectangle (Overrides FMX.RS.Charts.TRSCustomShapeChart.DrawShape(TCanvas,TCanvasRect,TRSShapeChartValue).)
DrawSmoothline(TCanvas,TCanvasRect,Boolean)
Draws the smooth line for the entire values collection (i.e., the LineStyle is lsCurveInterpolation or lsCurveApproximation). If the LineStyle is lsCurveInterpolation, it uses the DrawSmoothSegment method for each segment of the line. (Inherited from FMX.RS.Charts.TRSCustomLineChart.)
DrawSmoothSegment(TCanvas,TRS2DChartValue,TCanvasPoint,TCanvasPoints,Boolean)
Draws a smooth line segment using the SegmentPoints. The Line is assumed to touch all the segment points (i.e., the LineStyle is lsCurveInterpolation) (Inherited from FMX.RS.Charts.TRSCustomLineChart.)
Re-enables screen repainting and change events. Use EndUpdate to re-enable screen repainting and change events that were turned off with the BeginUpdate method. (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
FormatValue(TRSChartValue,TRSLabelTextStyle)
Generates a label for the Value based on the TextStyle (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Returns the vertical offset ( OffsetVertical).
If coUseVerticalOffset is not in Options, this method always returns 0. If coUseVerticalOffset is in Options, the function returns the OffsetVertical value.
GetAxisCaption(TRSChartAxis,Integer,TRSChartValueType)
Returns a label for an axis ( FMX.RS.ChartPanel.TRSChartAxis ) based on the input Value. The Index specifies where to start looking in the chart Values (for optimization purposes) and decrements from there until the closest chart value is found. (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Returns the chart type enumerated value for this class. Each chart class overrides this class function to return the RSChartConsts|TRSChartType enumerated value (Overrides FMX.RS.Charts.TRSCustomShapeChart.GetChartType.)
Represents method GetColor. (Overrides FMX.RS.ChartPanel.TRSCustomChart.GetColor.)
Overloaded. Returns the color of the chart value. The color of the TRSChartValue can change depending on the Options property as well as any other chart states (e.g., the TRSCandleStickChart class overrides this method to turn the color red or green depending on if the Open value is greater than the Closing Value) (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
GetCumulativeTotal(Integer,Integer,TRSCustomChartClass)
Determine the cumulative value at this index for all charts in the Group. The ValIndex specifies the TRSChartValue.Values dimension to compare.
Used for stacking charts.
GetCumulativeValue(Integer,Integer,TRSCustomChartClass)
Determine the cumulative value at this index for all charts below (spatially) this chart in the same Group. The ValIndex specifies the TRSChartValue.Values dimension to compare.
Used for stacking charts.
Represents method GetGroupDimension. (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
GetPoints(TCanvasPoint,TCanvasPoint,TCanvasRect)
Returns an array of points from StartPoint to EndPoint based on the LineStyle and LineChartElements (Inherited from FMX.RS.Charts.TRSCustomLineChart.)
GetShapeRect(TCanvasRect,TRSShapeChartValue)
Represents method GetShapeRect(TCanvasRect,TRSShapeChartValue). (Inherited from FMX.RS.Charts.TRSCustomShapeChart.)
Returns a new chart color based on the ChartColorScheme and ChartColorList. Every time a chart is created, it is assigned a new color from the current ChartColorList. (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Initialize the OnChange events of structures. Use this method to assign event handlers for structures (e.g., Pen.OnChange := MyChangeMethod).
Notes to Inheritors |
---|
The constructor calls this method after it calls the InitializeChart method, which is where the structures should be actually created and initialized. |
Creates and initialize structures and values of chart. This method is the safe place to initialize chart values without change events occurring.
Notes to Inheritors |
---|
The constructor calls this method. Use this method to actually create and initialize properties. Do not assign event properties in this method (use the InitializeChangeEvents method instead) |
InternalDraw(TCanvas,TCanvasRect)
Overloaded. Paints the chart graphic to the specified canvas at the specified rectangle. The InternalDraw method is called by the Draw method.
Descendant classes of TRSCustomChart override the InternalDraw method to actually paint themselves.
Notes to Inheritors |
---|
The default InternalDraw method implementation assigns the Brush, Pen , and Font to the Canvas. |
InternalSelect(TCanvasRect,TRSChartSelectionAction)
Selects or deselects chart Values ( FMX.RS.ChartPanel.TRSChartValue ) based on whether they intersect with the selection rectangle (which is in pixel coordinates).
The base method converts the SelectionRect to chart coordinates (based on HorizontalAxis and VerticalAxis) and then selects values based on the TRSChartValue.Selectable method
Represents method Invalidate. (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Returns True if any value in the chart intersects with the SelectionRect (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Represents method IsValuesStored. (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Indicates whether the chart is visible. A chart is visible if its Visible property is True and both axes have been assigned. (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Represents method Loaded. (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Represents method MouseHover(TCanvasRect). (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Notification(TComponent,TOperation)
Represents method Notification(TComponent,TOperation). (Overrides FMX.RS.Charts.TRSCustomPointChart.Notification(TComponent,TOperation).)
Represents method Paint. (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Represents method PanelChanged. (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Represents method RSVisibleChanged. (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
SaveCanvasResources(TCanvas,TBrush,TRSPen,TFont)
Represents method SaveCanvasResources(TCanvas,TBrush,TRSPen,TFont). (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Select(TCanvasRect,TRSChartSelectionAction)
Selects or deselects chart Values ( FMX.RS.ChartPanel.TRSChartValue ) based on whether they intersect with the selection rectangle (which is in pixel coordinates).
The base method converts the SelectionRect to chart coordinates (based on HorizontalAxis and VerticalAxis) and then selects values based on the TRSChartValue.Selectable method
Notes to Inheritors |
---|
Descendant classes override the InternalSelect method |
Represents method SelectionColorChanged. (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Overloaded. Represents method SenderChanged(TObject). (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
SetCanvasResources(TCanvas,TBrush,TRSPen,TFont,Boolean,Boolean)
Overloaded. Represents method SetCanvasResources(TCanvas,TBrush,TRSPen,TFont,Boolean,Boolean). (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
SetCanvasResources(TCanvas,TRSChartValue,Boolean,Boolean)
Represents method SetCanvasResources(TCanvas,TRSChartValue,Boolean,Boolean). (Overrides FMX.RS.Charts.TRSCustomPointChart.SetCanvasResources(TCanvas,TRSChartValue,Boolean,Boolean).)
Represents method SetColor(TCanvasColor). (Overrides FMX.RS.ChartPanel.TRSCustomChart.SetColor(TCanvasColor).)
Represents method SetOptions(TChartOptions). (Overrides FMX.RS.ChartPanel.TRSCustomChart.SetOptions(TChartOptions).)
Represents method SetVisible(Boolean). (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Represents method UpdateAxis(TRSChartAxis).
Represents method UpdateAxisInfo(TRSChartAxis). (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Updates the values to the current color scheme. If PanelColorScheme is True then uses the Panel's color scheme (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
ValueNotify(TRSChartValue,TCollectionNotification)
Represents method ValueNotify(TRSChartValue,TCollectionNotification). (Inherited from FMX.RS.Charts.TRSCustomShapeChart.)
ValueSelectionChanged(TRSChartValue)
Represents method ValueSelectionChanged(TRSChartValue). (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
ValueVisibleChanged(TRSChartValue)
Represents method ValueVisibleChanged(TRSChartValue). (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
Returns true if the chart prefers Captions over Values for its labels on the input Axis. This method provides a hint to the TRSChartAxis when LabelStyle is alsAutomatic. (Inherited from FMX.RS.ChartPanel.TRSCustomChart.)
|
|
To display a chart, you drop the component on a form and optionally connect its Panel property to the FMX.RS.ChartPanel.TRSChartPanel component where you want it to be displayed. The Values property is the most important property of the chart type and allows you to define the chart values at design-time or run-time. For the Chart-In-Chart, the Values property contains TRSChartInChartValues collection items which define the shape, appearance, and sub-chart. To display a chart in chart inside a chart panel: • Drop a TRSChartInChart component on a form • Drop a TRSChartPanel component where you want the chart to be displayed. (Note, more than one chart can share the same chart panel) • Connect the Panel property of the chart to the chart panel |
To add a subchart to the chart (at Design-Time):
• Select the TRSChartInChart component • Click the ellipsis button (...) for the Values property of the chart. This action displays Delphi's Collection Editor for the TRSChartInChartValues collection. • Use the Add button to add subcharts (TRSChartInChartValue collection item) to the chart. • Edit the X and Y, Width and Height properties for the point • Edit the Style property to change the shape (rectangle, ellipsis, etc) of the subchart frame • Edit the SubChartType property to create the subchart • Edit the TextBoxAlignment property to change where the caption will go for the subchart.. |
To add a subchart to the chart (at Run-Time):
Delphi |
---|
var |
To hide the display of the sub-chart axes (at Design-Time). Note that the display of the axes will still depend on the AxisThreshold property:
• Select the TRSChartInChart component
• Set the SubChartHorizontalAxis.Visible property to False
• Set the SubChartVerticalAxis.Visible property to False
Reference•FMX.RS.ChartPanel.TRSCustomChart •FMX.RS.ChartPanel.TRSChartPanel •TRSDBChartInChart |