|
Background
|
The Background property is the surface or layer behind all chart panel elements. Set the properties of the Background property to change the visual aspect of the background.
A chart layer is similar to layers in Adobe Photoshop. The TRSChartPanel component displays itself using layers: there is a Background layer that is painted first followed by a Gradient layer which is painted on top (and can obscure) the background layer. Then, the ChartBackground layer and the Charts and related graphical elements are displayed (e.g., Header, Footer, Legend, axes). Finally, the TRSChartPanel paints a Foreground layer on top of everything. The FMX.RS.ChartPanel.TRSChartLayer class provides the graphical properties for the Background and Foreground layers.
|
|
BottomAxis
|
Provides the properties and behavior of the top (horizontal) chart axis for a TRSCustomChartPanel component. The FMX.RS.ChartPanel.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 FMX.RS.ChartPanel.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.
|
|
Canvas
|
Represents property Canvas.
|
|
ChartBackground
|
The ChartBackground property is the surface or layer behind all charts, e.g. the ChartRect area. Set the properties of the ChartBackground property to change the visual aspect of the chart background.
A chart layer is similar to layers in Adobe Photoshop. The TRSChartPanel component displays itself using layers: there is a Background layer that is painted first followed by a Gradient layer which is painted on top (and can obscure) the background layer. Then, the ChartBackground layer and the Charts and related graphical elements are displayed (e.g., Header, Footer, Legend, axes). Finally, the TRSChartPanel paints a Foreground layer on top of everything. The FMX.RS.ChartPanel.TRSChartLayer class provides the graphical properties for the Background and Foreground layers.
|
|
ChartColorList
|
Defines the color list to use when new charts are created. When a chart is created and a color is not specified, the object will get a new color based on the next color in the list. If the list is at the end, the new color will be the first color in the list.
Set the ChartColorList property directly to define your own custom color scheme. Set the ChartColorScheme property to use one of the predefined color lists.
|
|
ChartColorScheme
|
Defines the color scheme to use when new charts are created. When a chart is created and a color is not specified, the object will get a new color based on the next color in the color scheme.
Setting the ChartColorScheme property sets the ChartColorList property. Set the ChartColorList property directly to define your own custom color scheme.
|
|
ChartRect
|
Specifies the size (in pixels) of the area of the panel that contains the actual charts, e.g., where the charts are drawn. This is the area of the panel that does not include the Header, Footer, axes, etc. Read ChartRect to find the size of the chart area of the chart panel. The ChartRect will change in response to what elements of the chart panel are visible and their size.
|
|
Charts
|
Contains the list of charts associated with the chart panel, e.g., their Panel property is set to the chart panel.
Note
|
The order of the charts in the list matters. The chart at Index 0 is drawn first, and then every chart is drawn over it.
|
|
|
ChartShadow
|
Controls the visibility as well as the size and direction of the shadows drawn for the charts in the chart panel. The ChartShadow property is used by the Charts for specifying how they cast a shadow. Change the Size and Direction properties to control the direction and "length" of the shadow. Change the Brush and Pen to change the appearance of the shadow. Finally, use the Visible property to turn chart shadows on or off.
|
|
DrawAreas
|
Represents property DrawAreas.
|
|
Font
|
Specifies the attributes of text written on or in the control.
To change to a new font, specify a new TFont object. To modify a font, change the value of the Family, Size, or Style of the TFont object
|
|
Footer
|
Controls the appearance of the footer of the chart panel, e.g., the area at the bottom of the chart panel. Change the properties of the footer to change the Text drawn at the bottom of the chart as well as the footer background. Use the Visible property to hide or show the footer.
|
|
Foreground
|
The Foreground property is the surface or layer in front of all chart panel elements. Set the properties of the Foreground property to change the visual aspect of the background. Note that the Foreground can obscure either partially or completely the other elements of a chart panel.
A chart layer is similar to layers in Adobe Photoshop. The TRSChartPanel component displays itself using layers: there is a Background layer that is painted first followed by a Gradient layer which is painted on top (and can obscure) the background layer. Then, the ChartBackground layer and the Charts and related graphical elements are displayed (e.g., Header, Footer, Legend, axes). Finally, the TRSChartPanel paints a Foreground layer on top of everything. The FMX.RS.ChartPanel.TRSChartLayer class provides the graphical properties for the Background and Foreground layers.
|
|
Gradient
|
Provides the chart panel the ability to draw a gradient as the background of the chart panel. If the Gradient is Visible, it completely covers the Background of the chart panel.
|
|
GradientBuffer
|
Represents property GradientBuffer.
|
|
Header
|
Controls the appearance of the header of the chart panel, e.g., the area at the top of the chart panel. Change the properties of the header to change the Text drawn at the top of the chart as well as the header background. Use the Visible property to hide or show the header.
|
|
HintWindow
|
Represents property HintWindow.
|
|
LeftAxis
|
Provides the properties and behavior of the left (vertical) chart axis for a TRSCustomChartPanel component. The FMX.RS.ChartPanel.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 FMX.RS.ChartPanel.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.
|
|
Legend
|
Controls the appearance of the built-in legend of a chart panel. The legend is the box in chart graphics where the points of a chart are labeled or all the charts being displayed are labeled. The Legend has properties including BoxSize, Lines, and LegendStyle. Use the Visible property to hide or show the Legend.
Usually, the legend dynamically chooses and updates the Lines property to determine what to show. By using the OnGetLegendStrings event, you can add lines to the top of the legend. By using the Fixed property, you can update the Lines and the legend will not overwrite them.
Tip
|
Use the stand-alone legend controls (TRSLegendListBox and TRSChartLegendBox) for more control and visual appeal than the built-in legend.
|
|
|
Listeners
|
Maintains a list of IChartPanelListeners that are interested in changes to the chart panel. The TRSCustomChartPanel control will call the Listeners' methods as changes (adding, deleting, and modifying charts and chart values) occur in the control.
Notes to Implementers
|
Add your class (that implements the IChartPanelListener interface) to this list in order to receive chart and chart value changes without using the regular events. The TRSLegendListBox and TRSChartFunction classes use this mechanism to listen to the chart panel without tieing up the event handlers (leaving them free for users)
|
|
|
Margins
|
Specifies the margins, or empty space, for the top, left, right, and bottom of the chart panel. The Header, Footer, axes, and all other chart elements are placed inside these margins. Use the Margins property to specifies the chart panel margins in canvas pixels (integer in VCL and single floating point in FMX)
|
|
MouseTrackingOn
|
Represents property MouseTrackingOn.
|
|
MouseTrackingPoint
|
Represents property MouseTrackingPoint.
|
|
OnChange
|
Occurs when the chart panel changes. Write an OnChange event handler to take action when the chart panel changes.
|
|
OnGetLegendStrings
|
Occurs when the Legend is compiling the strings - the Lines - that compose the legend. The event occurs before the Legend fills its Lines property. Use the OnGetLegendStrings event to add extra text to the top of the legend.
|
|
OnPan
|
Occurs when the chart panel pans its visual window. The OnPan event occurs after the Pan has actually occurred. Use the OnPan event handler to take action when a pan occurs.
|
|
OnUnzoom
|
Occurs when the chart panel unzooms its visual window. The OnUnzoom event occurs after the UnZoom has actually occurred. Use the OnUnzoom event handler to take action when an unzoom occurs.
|
|
OnZoom
|
Occurs when the chart panel zooms its visual window. The OnZoom event occurs after the Zoom has actually occurred. Use the Onzoom event handler to take action when a zoom occurs
|
|
RightAxis
|
Provides the properties and behavior of the right (vertical) chart axis for a TRSCustomChartPanel component. The FMX.RS.ChartPanel.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 FMX.RS.ChartPanel.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.
|
|
SelectionBox
|
Represents property SelectionBox.
|
|
SelectionColor
|
Defines the color to draw a chart value when it is selected. When a chart value's Selected property is False, the chart value is painted with either the Chart's Color or the chart value's Color (depending on chart Options). However, when a chart value is selected, this property provides the color of the chart value.
|
|
TopAxis
|
Provides the properties and behavior of the bottom (horizontal) chart axis for a TRSCustomChartPanel component. The FMX.RS.ChartPanel.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 FMX.RS.ChartPanel.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.
|
|
UserAction
|
Represents property UserAction.
|
|
UserActions
|
Defines the actions that the user may take with the chart panel. Use the UserActions to enable or disable actions that the user may take with the chart panel. The UserPan, UserSelect, and UserZoom properties define how the user interacts with the chart panel.
|
|
UserPan
|
Defines the mouse and keyboard action the user must perform in order to Pan the chart panel. Note that this property only defines the action the user must take. The UserActions property actually enables or disables the action.
|
|
UserProportional
|
Defines the mouse and keyboard action the user must perform in order to constrain the aspect ratio when zooming the chart panel, i.e., the zoomed rectangle is proportional to the ChartRect.
|
|
UserSelect
|
Defines the mouse and keyboard action the user must perform in order to select chart values in the chart panel. Note that this property only defines the action the user must take. The UserActions property actually enables or disables the action.
|
|
UserZoom
|
Defines the mouse and keyboard action the user must perform in order to Zoom the chart panel. Note that this property only defines the action the user must take. The UserActions property actually enables or disables the action.
|