| Contents page
Previous | Next
Tutorial 17 - TeeChart's Additional palette components
- 1 Tutorial 17 - TeeChart's Additional palette components
- 1.1 Using the additional TeeChart Controls
- 1.1.1 Selecting and inserting the component
- 1.1.2 Associating the component with a TChart
- 1.1.3 TeeListBox
- 1.1.4 TeeEditor
- 1.1.5 TeePreviewer
- 1.1.6 TeeCommander
- 1.1.7 TeePreviewPanel
- 1.1.8 ChartGrid
- 1.1.9 ChartGridNavigator
- 1.1.10 ChartPageNavigator
- 1.1.11 ChartEditorPanel
- 1.1.12 SeriesTextSource
- 1.1.13 SeriesXMLSource
- 1.1.14 CrossTabSource
- 1.1 Using the additional TeeChart Controls
Using the additional TeeChart Controls
TeeChart Pro AX v5 includes several new controls that may be added to a project to enhance runtime functionality of a Charting application.
*Note For MS VC there are some points that you should take into account when using the additional TeeChart components. Please read the sections below as a general guide and look at the [tutorial15.htm#InstallComps VC tutorial] for specific VC related information.
Selecting and inserting the component
When you add TeeChart Pro to the Visual Basic Component panel the additional controls are automatically added too. For MS VC , MS J and other development environments such as MS Access and Powerbuilder the controls are separately itemised in the Registered Controls list so you will need to select and add them individually.
Associating the component with a TChart
Associate TeeCommander and the other Non-Chart components with a TChart by using the Chart or ChartLink properties. The Chart property connects directly to the Chart interface which is supported with MS Visual Basic and Internet Explorer. For MS VC , VJ , Sybase Powerbuilder and other environments you will need to use the ChartLink property which returns the integer value of the Chart location.
'Visual Basic TeeCommander1.Chart = TChart1 or TeeCommander1.ChartLink = TChart1.ChartLink **** VC and other environments **** eg. MS VC m_Commander1.SetChartLink(m_Chart1.GetChartLink());
Visible Components Example
Private Sub Form_Load() With TChart1 .AddSeries scArea .AddSeries scBar .AddSeries scLine .AddSeries scPoint For i = 0 To 3 For j = 0 To 100 .Series(i).AddXY j, Rnd(j) * 100, Chr(65 j), clTeeColor Next j .Series(i).Marks.Visible = False Next i .Page.MaxPointsPerPage = 10 .Legend.Visible = False .Aspect.View3D = True .Aspect.Orthogonal = True .Panel.Gradient.Visible = True .Panel.Gradient.StartColor = vbCyan .Panel.Gradient.EndColor = vbBlue .Tools.Add tcPageNumber With .Tools.Items(0).asPageNum .Position = ppLeftTop .Shape.Color = vbGreen End With End With ChartEditorPanel1.Chart = TChart1 ChartGrid1.Chart = TChart1 ChartGridNavigator1.Grid = ChartGrid1 ChartPageNavigator1.Chart = TChart1 TeeCommander1.Chart = TChart1 TeeListBox1.Chart = TChart1 TeePreviewPanel1.Chart = TChart1 End Sub
TeeListBox shows a list of Series in the Chart at runtime. The ListBox may be used to offer the user limited customisation and display/hide of Chart Series.
The TeeEditor component is non visible at runtime. Use the properties of this component to define the runtime Editor displayed to the user. Call the Editor with the ShowEditor method or associate the Editor with the TeeCommander bar to define characteristics of the Editor run from TeeCommander.
The TeePreviewer component is non visible at runtime. Use the properties of this component to define the runtime Previewer displayed to the user. Call the Previewer with the ShowPreviewer method or associate the Previewer with the TeeCommander bar to define characteristics of the Previewer run from TeeCommander.
The TeeCommander bar allows navigation and parameter change control (via the Chart Editor) to be offered to users at runtime. Select the navigation buttons and with the left mouse button depressed, drag over the Chart panel to move the Chart. The EditorLink and PreviewerLink properties may be used to associate the runtime properties defined by those 2 components to the characteristics of the Chart Editor and Previwer when called from TeeCommander.
The TeePreviewPanel allows the visualisation of your Chart on a printed page at runtime. The Chart's margins can be dragged to the desired position.
The ChartGrid shows the data in all the Chart's series. This data may be modified directly via Grid and the Grid itself may be associated with a ChartGridNavigator for easy reading.
The ChartGridNavigator, when associated with a ChartGrid via the Grid property, allows easy reading of and navigation through the ChartGrid.
The ChartPageNavigator facilitates the visualisation of a multi-page Chart when it is associated to one via the Chart property.
The ChartEditorPanel displays the Chart Editor at run-time in a Panel on your form or HTML page.
The SeriesTextSource is non-visible at run-time. It allows data to be brought in from text files to specified Chart series. Use this compenent's methods and properties to define or modify the data's fields and field delimiters and to set the location of the textfile as a path, URL or stream.
TChart1.AddSeries(scSurface) With SeriesTextSource1 ' AddField AName refers to the Series ValueList name ' The AIndex refers to the Column index of the text file ' beginning with Column 1 .AddField "X", 1 .AddField "Y", 2 .AddField "Z", 3 ' Check for locale decimal separator on PC ' and import formetted textfile accordingly If CInt("5,3") < CInt("5.3") Then .FileName = App.Path & "\SampleData.txt" Else .FileName = App.Path & "\SampleDataPoint.txt" End If .Series = TChart1.Series(0) ' or Series may be passed as Index but you would then ' have to set the Chart for the source 'eg. ' .Chart = TChart1 ' .Series = 0 .Active = True End With
The SeriesTextSource is non-visible at run-time. It allows data to be brought in from XML files to specified Chart series. Use this compenent's methods and properties to define or modify the data's fields and field delimiters and to set the location of the XML file as a path, URL or stream.
Private Sub Form_Load() TChart1.AddSeries scBar With SeriesXMLSource1 .FileName = "http://www.steema.com/SampleData.xml" 'This can also be a local file .Series = TChart1.Series(0) .SeriesNode = "USA" .ValueSource = "Bar" .Open End With End Sub
The CrossTabSource is non-visible at run-time. CrossTabSource component connects to any dataset and automatically creates series from database data, using Group and Label fields and formula (sum or count values).
Private Sub Command1_Click() Dim tmp As String With CrossTabSource1 tmp = .GroupField .GroupField = .LabelField .LabelField = tmp .Active = True End With TChart1.RefreshData End Sub Private Sub Form_Load() TChart1.AddSeries scBar With CrossTabSource1 .Series = TChart1.Series(0) .GroupField = "Terms" .LabelField = "Paymtype" .ValueField = "Amntpaid" .DataSet = "DSN=TeeChart Pro System db; SQL=select * from orders" .Active = True End With TChart1.RefreshData End Sub
© 1998-2019 Steema Software SL. All rights reserved.