TTMSFNCBarChart Class
Convenience chart control pre-configured with a bar (
ctBar) series type.
API unit family: TMSFNCChart
Inherits from: TTMSFNCChart
Syntax
TTMSFNCBarChart = class(TTMSFNCChart)
Properties
| Name | Description |
|---|---|
| Adapter | Optional data adapter that populates the chart from an external data source. (inherited from TTMSFNCChart) |
| AntiAliasing | When True (default), the chart renders with anti-aliasing for smoother lines and curves. (inherited from TTMSFNCChart) |
| Appearance | Global chart appearance settings including color scheme, color list, and font propagation. (inherited from TTMSFNCChart) |
| ClickMargin | Pixel radius used to detect clicks on data points, bars, and slices; larger values make hit-testing more forgiving. (inherited from TTMSFNCChart) |
| Crosshair | Global crosshair settings; per-series appearance is configured through TTMSFNCChartSerie.Crosshair. (inherited from TTMSFNCChart) |
| DefaultLoadOptions | Default import options used when loading data from CSV or JSON without explicit options; can be shared across multiple load calls. (inherited from TTMSFNCChart) |
| DrawOrder | Controls z-order when bar series and other series types are rendered together; default is csdoBarsFirst. (inherited from TTMSFNCChart) |
| Fill | Fill settings for the chart background area. (inherited from TTMSFNCChart) |
| Interaction | When True (default), mouse and touch interaction (zooming, panning, clicking) is active. (inherited from TTMSFNCChart) |
| InteractionOptions | Mouse and touch interaction settings including scale mode, panning, and editor access. (inherited from TTMSFNCChart) |
| Legend | Chart-level legend settings including position, font, and visibility. (inherited from TTMSFNCChart) |
| NativeCanvas | When True, uses the platform-native canvas for rendering instead of the cross-platform canvas; default is True on VCL, False on other frameworks. (inherited from TTMSFNCChart) |
| Orientation | Controls the chart rendering orientation; coVertical (default) draws y-values upward, coHorizontal rotates the chart 90 degrees. (inherited from TTMSFNCChart) |
| SerieByName | Returns the series whose LegendText matches AName; returns nil if not found. (inherited from TTMSFNCChart) |
| Series | Collection of chart series; use BeginUpdate and EndUpdate when adding multiple series at once. (inherited from TTMSFNCChart) |
| SeriesMargins | Margin settings applied around the series drawing area inside the chart control. (inherited from TTMSFNCChart) |
| Stroke | Stroke settings for the chart border. (inherited from TTMSFNCChart) |
| TextQuality | Controls text rendering quality; default is gtqAntiAliasing. (inherited from TTMSFNCChart) |
| Title | Top and bottom chart title settings including text, font, visibility, and position. (inherited from TTMSFNCChart) |
| Version | Component version string. (inherited from TTMSFNCChart) |
| XAxis | Global x-axis appearance settings; per-series tick values are configured through TTMSFNCChartSerie.XValues. (inherited from TTMSFNCChart) |
| YAxis | Global y-axis appearance settings; per-series tick values are configured through TTMSFNCChartSerie.YValues. (inherited from TTMSFNCChart) |
Methods
| Name | Description |
|---|---|
| AddBandSerie | Adds a band series with explicit start and end values for both the upper and lower boundary. (inherited from TTMSFNCChart) |
| AddLineSerie | Adds a straight line series spanning the given x range with start and end y values; useful for reference lines. (inherited from TTMSFNCChart) |
| AddMovingAverage | Adds a moving average line computed from the series at the given index using the specified window size. (inherited from TTMSFNCChart) |
| AddParetoLine | Adds a Pareto cumulative-percentage line overlaid on the series at the given index. (inherited from TTMSFNCChart) |
| AddPointArray | Creates a new series from a flat array of y-values and returns it. (inherited from TTMSFNCChart) |
| AddSeriesFromDataArray | Creates a new series from y-values (and optional x-values and labels) and returns it. (inherited from TTMSFNCChart) |
| AddTrendChannel | Adds upper and lower trend channel line series around the series at the given index; equivalent to AddTrendChannelBand but does not return the series. (inherited from TTMSFNCChart) |
| AddTrendChannelBand | Adds a band series representing the trend channel around the series at the given index. (inherited from TTMSFNCChart) |
| AddTrendLine | Adds a linear trend line computed from the series at the given index. (inherited from TTMSFNCChart) |
| AppendFromDataArray | Appends y-values to an existing series without removing existing points; returns the series. (inherited from TTMSFNCChart) |
| BeginUpdate | Begins a framework override batch update; call EndUpdate when done to redraw once. (inherited from TTMSFNCChart) |
| CMGesture | Handles platform gesture input for chart interaction. (inherited from TTMSFNCChart) |
| Clear | Removes all series and their points from the chart. (inherited from TTMSFNCChart) |
| DrawChart | Renders the chart into the provided graphics context within the given rectangle; used for custom drawing and export. (inherited from TTMSFNCChart) |
| EndUpdate | Ends a framework override batch update and redraws the chart once. (inherited from TTMSFNCChart) |
| GetChartRectangle | Returns the full chart bounding rectangle including all chart elements. (inherited from TTMSFNCChart) |
| GetSeriesRectangle | Returns the bounding rectangle of the series drawing area excluding axes and titles. (inherited from TTMSFNCChart) |
| InitSample | Populates the chart with sample data for design-time preview; override to provide component-specific sample content. (inherited from TTMSFNCChart) |
| IsHorizontal | Returns True when Orientation is coHorizontal. (inherited from TTMSFNCChart) |
| LoadFromCSVData | Imports series and points from a CSV file; creates a series for each column in YValueColumnIndexesArray. (inherited from TTMSFNCChart) |
| LoadFromCSVDataEx | Imports series from a CSV file including band and variable-radius columns using explicit load options. (inherited from TTMSFNCChart) |
| LoadFromCSVMultiPointData | Imports OHLC or box plot series from a CSV file using explicit load options. (inherited from TTMSFNCChart) |
| LoadFromCSVStreamData | Imports series from a CSV stream using explicit load options. (inherited from TTMSFNCChart) |
| LoadFromCSVStreamDataEx | Imports series from a CSV stream including band and variable-radius columns using explicit load options. (inherited from TTMSFNCChart) |
| LoadFromCSVStreamMultiPointData | Imports OHLC or box plot series from a CSV stream using explicit load options. (inherited from TTMSFNCChart) |
| LoadFromCSVTextData | Imports series from a CSV string using explicit load options. (inherited from TTMSFNCChart) |
| LoadFromCSVTextDataEx | Imports series from a CSV string including band and variable-radius columns using explicit load options. (inherited from TTMSFNCChart) |
| LoadFromCSVTextMultiPointData | Imports OHLC or box plot series from a CSV string using explicit load options. (inherited from TTMSFNCChart) |
| LoadFromDataArray | Replaces the points in an existing series with y-values from the array and returns the updated series. (inherited from TTMSFNCChart) |
| LoadFromJSONData | Imports series and points from a JSON file; specify JSON key names for series, points, and y-values. (inherited from TTMSFNCChart) |
| LoadFromJSONDataEx | Imports series and points from a JSON file including optional secondary and variable-radius values. (inherited from TTMSFNCChart) |
| LoadFromJSONMultiPointData | Imports OHLC or box plot series from a JSON file. (inherited from TTMSFNCChart) |
| LoadFromJSONStreamData | Imports series and points from a JSON stream. (inherited from TTMSFNCChart) |
| LoadFromJSONStreamDataEx | Imports series from a JSON stream including secondary and variable-radius values. (inherited from TTMSFNCChart) |
| LoadFromJSONStreamMultiPointData | Imports OHLC or box plot series from a JSON stream. (inherited from TTMSFNCChart) |
| LoadFromJSONTextData | Imports series and points from a JSON string. (inherited from TTMSFNCChart) |
| LoadFromJSONTextDataEx | Imports series from a JSON string including secondary and variable-radius values. (inherited from TTMSFNCChart) |
| LoadFromJSONTextMultiPointData | Imports OHLC or box plot series from a JSON string. (inherited from TTMSFNCChart) |
| LoadSettingsFromFile | Restores chart settings from a previously saved JSON settings file. (inherited from TTMSFNCChart) |
| LoadSettingsFromStream | Restores chart settings from a stream containing previously saved JSON settings. (inherited from TTMSFNCChart) |
| Paint | Paints the chart control. (inherited from TTMSFNCChart) |
| Resize | Updates the chart layout after the control size changes. (inherited from TTMSFNCChart) |
| SaveSettingsToFile | Saves the current chart settings to a file in JSON format. (inherited from TTMSFNCChart) |
| SaveSettingsToStream | Saves the current chart settings to a stream in JSON format. (inherited from TTMSFNCChart) |
| SaveToBase64 | Exports the current chart image as a Base64-encoded string. (inherited from TTMSFNCChart) |
| SaveToImage | Exports the current chart appearance to an image file; the format is inferred from the file extension. (inherited from TTMSFNCChart) |
| SetAutoXRange | Sets the x auto-range mode for a single series or all series at once. (inherited from TTMSFNCChart) |
| SetAutoYRange | Sets the y auto-range mode for a single series or all series at once. (inherited from TTMSFNCChart) |
| SetXValuesPosition | Sets the x-axis position flags for the series at the given index, optionally clearing other position flags first. (inherited from TTMSFNCChart) |
| SetYValuesPosition | Sets the y-axis position flags for the series at the given index, optionally clearing other position flags first. (inherited from TTMSFNCChart) |
| ShowEditor | Opens the specified chart editor dialog for the given series index. (inherited from TTMSFNCChart) |
| XYToArea | Returns the line or area series whose hit area contains the given screen coordinates; returns nil if none. (inherited from TTMSFNCChart) |
| XYToBar | Returns the bar rectangle point under the given screen coordinates; returns nil if none. (inherited from TTMSFNCChart) |
| XYToBarVirtual | Returns True and fills APoint when a virtual bar is under the given screen coordinates. (inherited from TTMSFNCChart) |
| XYToClosestDrawPoint | Returns True and fills ADrawPoint when the closest rendered point to the screen coordinates is within the click margin. (inherited from TTMSFNCChart) |
| XYToLegendItem | Returns the index of the chart-level legend item under the given screen coordinates; returns -1 if none. (inherited from TTMSFNCChart) |
| XYToPoint | Returns the data point (marker) under the given screen coordinates; returns nil if none. (inherited from TTMSFNCChart) |
| XYToPointVirtual | Returns True and fills APoint when a virtual marker point is under the given screen coordinates. (inherited from TTMSFNCChart) |
| XYToSerieLegendItem | Returns the index of the series legend item under the given screen coordinates, and sets ASerie to the owning series; returns -1 if none. (inherited from TTMSFNCChart) |
| XYToSlice | Returns the pie or spider slice point under the given screen coordinates; returns nil if none. (inherited from TTMSFNCChart) |
| XYToSliceVirtual | Returns True and fills APoint when a virtual slice is under the given screen coordinates. (inherited from TTMSFNCChart) |
| XYToTitle | Returns True when the given screen coordinates fall within the chart title area. (inherited from TTMSFNCChart) |
| XYToXAxis | Returns True when the given screen coordinates fall within the x-axis area. (inherited from TTMSFNCChart) |
| XYToYAxis | Returns True when the given screen coordinates fall within the y-axis area. (inherited from TTMSFNCChart) |
Events
| Name | Description |
|---|---|
| OnAfterDrawBackground | Fires after the chart background has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawChart | Fires after the chart content has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawLegend | Fires after the chart legend has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawLegendIcon | Fires after a legend icon has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieAnnotation | Fires after a series point annotation has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieBar | Fires after a bar series bar has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieCrosshairHorizontalLine | Fires after the crosshair horizontal line has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieCrosshairVerticalLine | Fires after the crosshair vertical line has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieGridLegendText | Fires after spider grid legend text has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieLabel | Fires after a series point label has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieLegend | Fires after a series legend item has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieLegendIcon | Fires after a series legend icon has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieLegendIconVirtual | Fires after a virtual series legend icon has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieLine | Fires after a series line segment has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieMarker | Fires after a series data point marker has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieMultiPoint | Fires after an OHLC or box plot point has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieSlice | Fires after a pie or spider chart slice has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieXAxisCrosshairText | Fires after the x-axis crosshair value text has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieXGridLine | Fires after a vertical grid line has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieXValue | Fires after an x-axis tick value label has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieYAxisCrosshairText | Fires after the y-axis crosshair value text has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieYGridLine | Fires after a horizontal grid line has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSerieYValue | Fires after a y-axis tick value label has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawSeries | Fires after all series have been rendered in this paint cycle. (inherited from TTMSFNCChart) |
| OnAfterDrawTitle | Fires after the chart title has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawXAxis | Fires after the x-axis has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawXValuesTitle | Fires after the x-axis title has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawYAxis | Fires after the y-axis has been drawn. (inherited from TTMSFNCChart) |
| OnAfterDrawYValuesTitle | Fires after the y-axis title has been drawn. (inherited from TTMSFNCChart) |
| OnAnimateSerieFinished | Fires when a series animation sequence completes. (inherited from TTMSFNCChart) |
| OnAnimateSerieStarted | Fires when a series animation sequence begins. (inherited from TTMSFNCChart) |
| OnBeforeDrawBackground | Fires before the chart background is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawChart | Fires before the chart content is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawLegend | Fires before the chart legend is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawLegendIcon | Fires before a legend icon is drawn. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieAnnotation | Fires before a point annotation is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieBar | Fires before a bar is drawn; set ADefaultDraw to False to suppress default rendering. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieCrosshairHorizontalLine | Fires before the crosshair horizontal line is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieCrosshairVerticalLine | Fires before the crosshair vertical line is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieGridLegendText | Fires before spider grid legend text is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieLabel | Fires before a point label is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieLegend | Fires before a series legend item is drawn. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieLegendIcon | Fires before a series legend icon is drawn; set ADefaultDraw to False to replace the icon entirely. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieLegendIconVirtual | Fires before a virtual series legend icon is drawn; set ADefaultDraw to False to replace the icon. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieLine | Fires before a line segment is drawn; set ADefaultDraw to False to suppress default rendering. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieMarker | Fires before a series data point marker is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieMultiPoint | Fires before an OHLC or box plot point is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieSlice | Fires before a pie or spider chart slice is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieXAxisCrosshairText | Fires before the x-axis crosshair value text is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieXGridLine | Fires before a vertical grid line is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieXValue | Fires before an x-axis tick value label is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieYAxisCrosshairText | Fires before the y-axis crosshair value text is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieYGridLine | Fires before a horizontal grid line is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSerieYValue | Fires before a y-axis tick value label is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawSeries | Fires before all series are rendered in this paint cycle. (inherited from TTMSFNCChart) |
| OnBeforeDrawTitle | Fires before the chart title is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawXAxis | Fires before the x-axis is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawXValuesTitle | Fires before the x-axis title is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawYAxis | Fires before the y-axis is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeDrawYValuesTitle | Fires before the y-axis title is drawn; set ADefaultDraw to False to suppress. (inherited from TTMSFNCChart) |
| OnBeforeSetAllFonts | Fires before global font changes are propagated to chart elements; use the Boolean parameters to restrict which groups receive the change. (inherited from TTMSFNCChart) |
| OnCanLoadProperty | Fires before a property is deserialized; set the ACanLoad parameter to False to skip the property. (inherited from TTMSFNCChart) |
| OnCanSaveProperty | Fires before a property is serialized; set the ACanSave parameter to False to exclude the property. (inherited from TTMSFNCChart) |
| OnCustomizeAnnotationFill | Fires to allow customizing the fill of an annotation before it is rendered. (inherited from TTMSFNCChart) |
| OnCustomizeAnnotationFont | Fires to allow customizing the font of an annotation before it is rendered. (inherited from TTMSFNCChart) |
| OnCustomizeAnnotationStroke | Fires to allow customizing the stroke of an annotation before it is rendered. (inherited from TTMSFNCChart) |
| OnDrawTitleText | Fires to allow customizing or replacing the chart title text before it is drawn. (inherited from TTMSFNCChart) |
| OnGetAnnotation | Fires in virtual mode to retrieve annotation data for a virtual point. (inherited from TTMSFNCChart) |
| OnGetNumberOfAnnotations | Fires in virtual mode to retrieve the number of annotations on the specified virtual point. (inherited from TTMSFNCChart) |
| OnGetNumberOfPoints | Fires in virtual mode to retrieve the total number of points in the specified series. (inherited from TTMSFNCChart) |
| OnGetPoint | Fires in virtual mode to retrieve point data for the given series and point index. (inherited from TTMSFNCChart) |
| OnGetSerieLabel | Fires to override or format a data point label text. (inherited from TTMSFNCChart) |
| OnGetSerieLabelVirtual | Fires in virtual mode to retrieve or format a point label text. (inherited from TTMSFNCChart) |
| OnGetSerieLegendText | Fires to override or format a series legend item text. (inherited from TTMSFNCChart) |
| OnGetSerieLegendTextVirtual | Fires in virtual mode to retrieve or format a series legend item text. (inherited from TTMSFNCChart) |
| OnGetSerieSpiderLegendText | Fires to override or format a spider chart spoke legend text. (inherited from TTMSFNCChart) |
| OnGetSerieSpiderLegendTextVirtual | Fires in virtual mode to retrieve or format a spider chart spoke legend text. (inherited from TTMSFNCChart) |
| OnGetSerieXAxisCrosshairText | Fires to override or format the x-axis crosshair value text. (inherited from TTMSFNCChart) |
| OnGetSerieXValue | Fires to override or format an x-axis tick value text. (inherited from TTMSFNCChart) |
| OnGetSerieYAxisCrosshairText | Fires to override or format the y-axis crosshair value text. (inherited from TTMSFNCChart) |
| OnGetSerieYValue | Fires to override or format a y-axis tick value text. (inherited from TTMSFNCChart) |
| OnJSONAddPoint | Fires when a new point is created from JSON import; allows customizing the point using the raw JSON value. (inherited from TTMSFNCChart) |
| OnJSONAddSeries | Fires when a new series is created from JSON import; allows customizing the series using the raw JSON value. (inherited from TTMSFNCChart) |
| OnLegendItemClick | Fires when the user clicks on a legend item. (inherited from TTMSFNCChart) |
| OnParseDateTimeStringToDateTime | Fires when a date/time string cannot be parsed automatically during CSV or JSON import; set ADate to the parsed value. (inherited from TTMSFNCChart) |
| OnSerieAreaClick | Fires when the user clicks in a series area. (inherited from TTMSFNCChart) |
| OnSerieAreaVirtualClick | Fires in virtual mode when the user clicks in a series area. (inherited from TTMSFNCChart) |
| OnSerieBarClick | Fires when the user clicks on a bar in a bar series. (inherited from TTMSFNCChart) |
| OnSerieBarClickVirtual | Fires in virtual mode when the user clicks on a bar. (inherited from TTMSFNCChart) |
| OnSerieLegendItemClick | Fires when the user clicks on a series legend item. (inherited from TTMSFNCChart) |
| OnSeriePointClick | Fires when the user clicks on a data point marker. (inherited from TTMSFNCChart) |
| OnSeriePointClickVirtual | Fires in virtual mode when the user clicks on a data point. (inherited from TTMSFNCChart) |
| OnSerieSliceClick | Fires when the user clicks on a pie or spider chart slice. (inherited from TTMSFNCChart) |
| OnSerieSliceClickVirtual | Fires in virtual mode when the user clicks on a pie or spider chart slice. (inherited from TTMSFNCChart) |
| OnShowEditor | Fires when an editor dialog is about to open; inspect or modify AShowEditorParams to change which editor is shown or to suppress it. (inherited from TTMSFNCChart) |
| OnTitleClick | Fires when the user clicks on the chart title area. (inherited from TTMSFNCChart) |
| OnXAxisClick | Fires when the user clicks on the x-axis area. (inherited from TTMSFNCChart) |
| OnYAxisClick | Fires when the user clicks on the y-axis area. (inherited from TTMSFNCChart) |