Provides a stand-alone legend component for a FMX.RS.ChartPanel.TRSChartPanel or FMX.RS.ChartPanel.TRSCustomChart. This legend may be placed anywhere a normal control can be placed in your form.
Use the Panel property to select the TRSChartPanel to display charts or chart values from. The Chart property can be used to select the specific chart to display its values. The
LegendStyle property controls what is displayed in the legend. The TRSLegendListBox component implements the FMX.RS.ChartPanel.IChartPanelListener interface.
Namespace: FMX.RS.ChartLegends
TListBox
FMX.RS.ChartLegends.TRSLegendListBox
|
|
Name
|
Description
|
|
Chart
|
Specifies the chart that the legend should display values from. Note that this property will be set automatically to the active chart of a chart panel if the Panel property is set.
|
|
EnableSelection
|
Controls whether the legend will allow you to select chart values from the legend. In other words, as you click items in the legend, do the chart's values get Selected or not? Set EnableSelection to true if you want the user to be able to select chart values.
Note that if EnableSelection is true, MultiSelect is automatically true as the legend must display the selected chart values. Set EnableSelection to false if you want the legend to ignore user clicks on items.
|
|
LegendStyle
|
Controls the text style of the legend, e.g., what are the labels of the chart. (See TRSLegendStyle for more information). The legend uses the LegendStyle to determine what items to display in the chart. If the LegendStyle is lsAutomatic, the legend shows the Captions of the TRSCustomCharts (if the Panel is not nil and there is more than one chart attached to the panel) or the Captions of the TRSChartValues (if Panel is nil or there is only one chart attached to the Panel).
|
|
LegendTextStyle
|
Defines the format for the labels in the legend. See TRSLegendTextStyle for more information.
|
|
NeedsUpdate
|
Represents property NeedsUpdate.
|
|
Options
|
Specifies the options for the legend box or glyph
|
|
Panel
|
Specifies the TRSChartPanel that the legend should display charts and/or values for. Set the Panel property if you want the legend to display a legend similar to the Legend of the TRSChartPanel. In this case, the legend will display all the chart names if there is more than one chart attached to the panel. However, if there is only one chart attached to the panel, the legend would display the chart's values. To only display one chart's values, leave the Panel property blank and set the Chart property.
|
|
ShowCheckBoxes
|
Controls whether the legend shows check boxes for the visibility of the chart or chart values. Set ShowCheckBoxes to true if you want the legend to show check boxes. The check boxes will be checked for all visible charts or chart values. The user can then check or uncheck the boxes to control the visibility of the chart or values. Set ShowCheckBoxes to false to hide the check boxes and prevent the user from changing chart or value visibilities.
|
|
ShowScrollBars
|
Represents property ShowScrollBars.
|
Top
|
Unlike the chart panel legend ( FMX.RS.ChartPanel.TRSChartLegend ), the legend list box displays all values or charts in the legend and is not concatenated to fit within the panel. The TRSLegendListBox component displays checkmarks for all visible charts or values. Uncheck a chart or value to hide it, check a chart or value to display it. The TRSLegendListBox component can also be used to select (
Selected property) specific values of a chart. More than one TRSLegendListBox may be used at a time.
|
To display a list of all the charts of a chart panel:
• | Set the Panel property of the TRSLegendListBox to the TRSChartPanel |
• | Change the LegendStyle to lsChartNames. If you leave the LegendStyle as lsAutomatic, the legend will display all the chart names if there is more than one chart attached to the panel. However, if there is only one chart attached to the panel, the legend would display the chart's values. Use lsChartNames to force the legend to always display only the charts attached to the chart panel. |
|
To display one chart's values:
• | Drop a chart on a form. Note that the chart does not have to be visible or attached to a chart panel to display the values of the chart in the legend. |
• | Set the Chart property of the TRSLegendListBox to the chart
|
|
|