TMS SOFTWARE
TMS Advanced Charts
DEVELOPERS GUIDE
2
Index
TMS Advanced Charts availability ........................................................................................................... 5
TMS Advanced Charts use ....................................................................................................................... 5
TMS Advanced Charts organisation ........................................................................................................ 5
TAdvChartView .................................................................................................................................... 5
TAdvChartViewGDIP (GDI +) ................................................................................................................ 7
TAdvChartTypeSelector ....................................................................................................................... 7
TAdvChartPanesEditorDialog, TAdvChartSeriesEditorDialog, TAdvChartAnnotationsEditorDialog ... 9
Introduction to programmatic use of components in TMS Advanced Charts .................................. 11
TAdvChartView .................................................................................................................................. 11
TAdvChartViewGDIP (GDI +) .............................................................................................................. 11
TAdvChartTypeSelector ..................................................................................................................... 12
TAdvChartPanesEditorDialog, TAdvChartSeriesEditorDialog, TAdvChartAnnotationsEditorDialog . 13
TAdvChartLink ................................................................................................................................... 13
Applying a 3D effect to chart series .................................................................................................. 14
TMS Advanced Charts important methods and properties. ................................................................. 18
TAdvChartView .................................................................................................................................. 18
Tracker ........................................................................................................................................... 18
TChartPanes................................................................................................................................... 18
Global.......................................................................................................... 18
Crosshair ...................................................................................................... 20
Navigator ...................................................................................................... 21
Splitter ........................................................................................................ 22
X-axis .......................................................................................................... 22
Y-axis .......................................................................................................... 23
X-grid .......................................................................................................... 24
Y-grid .......................................................................................................... 24
TChartSeries .................................................................................................................................. 25
Global.......................................................................................................... 25
TChartSerie .................................................................................................................................... 27
Global.......................................................................................................... 27
Crosshair ...................................................................................................... 32
Marker ......................................................................................................... 33
Y-axis range configuration ................................................................................. 34
Y-axis visual configuration of multiple series values .................................................. 36
X-axis .......................................................................................................... 38
Different Bar Modes ......................................................................................... 40
Grouped Stacked Bars ...................................................................................... 42
Pie, Half-Pie / Donut, Half-Donut ........................................................................ 44
Spider / Halfspider .......................................................................................... 45
Variable Radius / Sized Pie ................................................................................ 46
Display of series values ..................................................................................... 47
TMS SOFTWARE
TMS Advanced Charts
DEVELOPERS GUIDE
3
X-Axis grouping .............................................................................................. 50
TChartAnnotation .......................................................................................................................... 52
General overview ............................................................................................ 52
Different kinds of annotations ............................................................................ 52
TAdvGDIPChartView ...................................................................................................................... 53
Zoom Control Window ...................................................................................... 53
TDBAdvChartView & TDBAdvGDIPChartView Basics ........................................................................ 54
Connecting DataSource to the Chart ............................................................................................. 54
Connecting Fields to Series............................................................................................................ 55
Programmatic use of DBAdvChartView & TDBAdvGDIPChartView .................................................. 57
Adding Special Series ............................................................................................................................. 60
Single versus multi value charts and data per chart point .................................................................... 63
Save and restore TAdvChartView settings ............................................................................................ 65
Printing .................................................................................................................................................. 66
Exporting to PNG, JPEG, TIFF, BMP or GIF files (GDI+) .......................................................................... 67
TMS Advanced Charts Tips and FAQ ..................................................................................................... 68
Programmatically scrolling and zooming in the chart ....................................................................... 68
Using Y-axis values per series in the chart ........................................................................................ 69
Add custom X-axis text programmatically......................................................................................... 70
Add custom X-axis values via an event.............................................................................................. 71
Updating chart at runtime ................................................................................................................. 72
Modifying a single series data point value in code ........................................................................... 72
Retrieving the series values at crosshair ........................................................................................... 73
TMS Advanced Charts 3D use ................................................................................................................ 74
TMS Advanced Charts 3D organisation ................................................................................................. 74
The visual organisation of TMS Advanced Charts 3D ........................................................................ 74
TAdvChartView3D ......................................................................................................................... 74
TAdvChartSeriesEditorDialog3D, TAdvChartPointsEditorDialog3D .............................................. 74
TMS Advanced Charts 3D in detail ........................................................................................................ 75
Title .................................................................................................................................................... 76
Series ................................................................................................................................................. 76
Points ................................................................................................................................................. 76
Legend ............................................................................................................................................... 78
Values ................................................................................................................................................ 78
Methods ............................................................................................................................................ 78
Properties .......................................................................................................................................... 78
TMS SOFTWARE
TMS Advanced Charts
DEVELOPERS GUIDE
4
Chart .............................................................................................................................................. 78
Chart - Title .................................................................................................................................... 79
Chart – Series ................................................................................................................................. 79
Chart - Series – Items/Points ......................................................................................................... 80
Chart - Series – Values ................................................................................................................... 81
Chart - Series – Legend .................................................................................................................. 83
Fill .................................................................................................................................................. 83
Border ............................................................................................................................................ 84
Multiple Series ................................................................................................................................... 84
Interaction ......................................................................................................................................... 85
AntiAliasing ........................................................................................................................................ 86
TMS SOFTWARE
TMS Advanced Charts
DEVELOPERS GUIDE
5
TMS Advanced Charts availability
TMS Advanced Charts is available as VCL component set for Win32/Win64 application development
and can be used as well with VCL for the Web (IntraWeb)
VCL versions:
TMS Advanced Charts is available for Delphi 7, 2006,2007,2009,2010,XE,XE2,XE3,XE4,XE5,XE6 &
C++Builder 2006,2007,2009,2010,XE,XE2,XE3,XE4,XE5,XE6.
TMS Advanced IntraWeb Charts is available for VCL for the Web (IntraWeb):
v12.x: Delphi 2009,2010,XE,XE2,XE3,XE4 & C++Builder 2009,2010,XE,XE2,XE3,XE4
v14.0.x: Delphi 2009,2010,XE,XE2,XE3,XE4,XE5,XE6 & C++Builder
2009,2010,XE,XE2,XE3,XE4,XE5,XE6
TMS Advanced Charts use
The TMS Advanced Charts is designed to display different kinds of data. From financial and
marketing data to monthly business sales, graphical and educative math data. The graphical user
interface supports chart types such as bar, histogram, area, line, ohlc, candlestick, and many
variants like stacked bar, stacked area, stacked percentage area, stacked percentage bar, pie
charts, donut chart, spider chart, bubble chart … The line, bar or area charts can be shown in
vertical and in horizontal direction. TMS Advanced Charts is easy to use with features like multiple
chart panes, scrolling, scaling, synched chart panes, synched crosshairs and much more…
TMS Advanced Charts organisation
TMS Advanced Charts is a component set which includes components such as TAdvChartView,
TDBAdvChartView, TAdvChartViewGDIP (GDI +), TDBAdvChartViewGDIP (GDI+), TAdvChartLink,
TAdvChartTypeSelector, and TMS Advanced Charts editors to edit panes, series and annotations.
TAdvChartView
TAdvChartView consists of multipane charts. This means that the chartview can have one or more
panes and each pane can display a chart with a single or multiple series. The charts on the panes
can scroll and zoom synchronously or can also do this independent of each other. The panes of the
chartview are accessible through the component’s Pane collection.
The major elements of the chart are indicated on this screenshot: