AXTutorial18

From Steema Software Reference Wiki
Jump to: navigation, search

Ax.png

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

  • teechart2012.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 Registry considerations] below).
  • teeuserx2012.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 Registry considerations] below).

Web browser application

  • teechart2012.cab or teechart2012.ocx
    You may use either file for a Web application (both can be found in/below the TeeChart installation folder). teechart2012.cab is the compressed version of teechart2012.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 Registry considerations]) in the client machine or loaded and registered dynamically using the HTML OBJECT Codebase link. See the [tutorial9.htm#CABFiles 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 [#AltCAB Alternative 'small' TeeChart CAB file] section.
  • teeuserx2012.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 Registry considerations] below).

* Use of PNG format export (all application types)

  • 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 teesmall5.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 teechart2012.cab file by using the HTML OBJECT Codebase parameter. See the [tutorial9.htm#CABFiles 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, teeuserx2012.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 teechart2012.ocx
    To manually register teechart2012.ocx use Window's Regsvr32.exe.
    Example
syntax:
  regsvr32.exe installdrive:\installfolder\teechart2012.ocx
eg.
  regsvr32 c:\Program files\MyChartApp\teechart2012.ocx
  • Register teeuserx2012.hlp
    To register teesuerx2012.hlp you must create a routine, or add manually, to the Windows registry the following:
Key:
  [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Help]
Entry:
  "teeuserx2012.hlp"="drive:\\installfolder\\installsubfolder"

Eg.
  "teeuserx2012.hlp"="c:\\Program files\\MyChartApp"

(Here assuming that teeuserx2012.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 teechart2012.cab file and HTML OBJECT Codebase, TeeChart is automatically registered with the client Windows machine. If you wish to use teeuserx2012.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 teeuserx2012.hpj help project.

Replacing the default teeuserx2012.hlp file with the modified version and registering it in your client machines as per the instructions in the [#Registry 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 v2012 on the same machine.

You may use TeeChart Pro AX v8 and TeeChart Pro AX v2012 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:

  • If your application does not code in the TeeChart GUIDs (as would happen automatically when TeeChart is placed on a Form) and uses, rather, only CreateObject for Chart instances, then the CreateObject will create a TeeChart Pro AX v2012 Chart. As code is backwards compatible in all but a very few instances (see [Tutorial15.htm#UpgradeFrom4 Tutorial 15, VC MS Applications] for details) then the change in version will be transparent to the application user. Specific version creation may be fixed by naming the version during create (eg. to create a TeeChart v6 Chart in VBScript: CreateObject(TeeChart.TChart.6)




PREVIOUS

NEXT


© 1998-2019 Steema Software SL. All rights reserved.