Contents page    Previous | Next

Tutorial 18 - TeeChart runtime installation requirements

TeeChart runtime requirements

This tutorial looks at some aspects of runtime installation for your TeeChart application.

TeeChart runtime Files

Which files to deliver with your TeeChart application depends on how the application is delivered. A standard Windows application differs from Web application delivery.

Windows application

• teechart2017.ocx
  The file can be found in the TeeChart installation folder. It may be installed to any folder of your choice on the client (runtime) machine but must be registered (see section Registry considerations below).


• teeuserx.hlp
  Optional Editor help support. The file can be found in Docs folder below the TeeChart installation folder. It may be installed to any folder of your choice on the client (runtime) machine but must be registered (see section Registry considerations below).

• teechart2017.cab or teechart2017.ocx
  You may use either file for a Web application (both can be found in/below the TeeChart installation folder). teechart2017.cab is the compressed version of teechart2017.ocx, more suitable for transferring across the Internet where speed is a consideration. The CAB file is authenticoded. The files may be installed manually and manually registered (see section Registry considerations) in the client machine or loaded and registered dynamically using the HTML OBJECT Codebase link. See the Internet applications tutorial for more information about the use of CAB files and codebase. Where speed for downloading is a more critical element of your application you may wish to consider the use of the alternative 'cutdown functionality' version of TeeChart as listed in the Alternative 'small' TeeChart CAB file section.
• teeuserx.hlp
  Optional Editor help support. The file can be found in Docs folder below the TeeChart installation folder. This file is not automatically registered when downloaded with an http connection so should be registered by alternative means (see section Registry considerations below).

• TeeChart Pro AX uses a dynamic link library, Lpng.dll to facilitate export to PNG format graphic files. The DLL is included with the TeeChart installer and is installed to the Windows\System[32] folder at installtime. If you require your redistributable application to export to PNG format files then you should include this DLL with your installer files. Lpng.dll is public domain. Version information may be found at http://www.libpng.org/.

Alternative 'small' TeeChart CAB file

An alternative TeeChart Cab file is supplied with the registered version. Located in the CAB files folder below the TeeChart installation folder, the file offers a limited functionality set of TeeChart, thus reducing the size of the Cab. The CAB file is authenticoded.

Functionality missing from the teesmall2017.cab file

• No TeeChart Editor
• No JPEG support
• No Print Previewer
• No About screen
• No ODBC access
• No OpenGL

The file may be made available in the same way as the teechart2017.cab file by using the HTML OBJECT Codebase parameter. See the Internet applications tutorial for more information about the use of CAB files and codebase.

Registry considerations

The TeeChart Pro ActiveX Control must be registered with the Windows registry to be useable. In most circumstances registration is achieved automatically but on some occasions (e.g. when creating your own application installation routines) it is necessary to manually register the Control. The TeeChart runtime Editor helpfile, teeuserx.hlp must also be registered to support help calls from the TeeChart Editor at runtime.

When creating an installer or installation routine for your compiled Charting applications you should include these aspects for TeeChart registration:

• Register teechart2017.ocx
  To manually register teechart2017.ocx use Window's Regsvr32.exe.
  Example
  

  syntax:
    regsvr32.exe installdrive:\installfolder\teechart2017.ocx
  eg.
    regsvr32 c:\Program files\MyChartApp\teechart2017.ocx
  

teeChart2017.ocx registry entries will be automatically added to several places of the Windows registry. There is no need to manually edit the registry.
• Register teeuserx.hlp
  To register teesuerx.hlp you must create a routine, or add manually, to the Windows registry the following:

  Key:
    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Help]
  Entry:
    "teeuserx.hlp"="drive:\\installfolder\\installsubfolder"
  
  Eg.
    "teeuserx.hlp"="c:\\Program files\\MyChartApp"
  
  (Here assuming that teeuserx.hlp is installed in the 
   c:\Program files\MyChartApp folder)
  
  You may create a .reg registry file (which is ascii format) 
  by exporting the key from an existing registry entry. 
  The file may be used for direct importation to a client 
  installation.
  

When using the teechart2017.cab file and HTML OBJECT Codebase, TeeChart is automatically registered with the client Windows machine. If you wish to use teeuserx.hlp for web browser applications you must create your own routines for registering the helpfile. That could optionally involve the use of an exported registry file (normally ending with .reg) that automatically updates the register when executed (e.g. double-clicked).

Customising TeeUser runtime help

The source of the teeuser runtime Editor help, an rtf file, is saved in the Docs\Teeuser help source folder below the TeeChart Pro installation folder. The help source may be edited with a standard 32Bit Windows Help Editor or with Microsoft Word95 and compiled with Microsoft's 32bit Help Editor v4.00.0950+ or with Microsoft Word97/2000 and compiled with Microsoft's 32bit Help Editor v4.02.0060+. If edited with Word97 you cannot compile with the earlier version of Microsoft's 32bit Help Editor. The Help Editor is freely available from Microsoft.

When editing/compiling with a standard Help Editor or compiling with Microsoft's help compiler, open the teeuserx.hpj help project.

Replacing the default teeuserx.hlp file with the modified version and registering it in your client machines as per the instructions in the Registry considerations section will enable that help for use at runtime.
*Note
If using Word to edit the help .rtf file, be sure to edit page contents only and not to modify footnotes or hidden codes. To that measure, to avoid mistakes, it is advisable to work with the Word option, 'Show codes', activated.

OpenGL support

To use OpenGL support at designtime or runtime, be sure to have OpenGL enabled in the Windows machine. The standard Microsoft dll, OpenGL32.dll, is normally located in the Windows\System folder in the case of Windows95 and Windows98 and in the Winnt\System32 folder in the case of Windows NT.

Alternative OpenGL drivers are available form Silicon Graphics, www.sgi.com, both for NT and Windows 95/98.
Depending on your CPU and video hardware, it may be that the OpenGL dll's from Silicon Graphics are faster than the ones from Microsoft.

Running TeeChart Pro AX v8 and TeeChart Pro AX v2017 on the same machine.

You may use TeeChart Pro AX v8 and TeeChart Pro AX v2017 alongside each other on the same PC. Applications compiled with TeeChart Pro AX 8 or earlier will continue to use that version. Please take into account the following considerations: