TFORMer Class Reference

Provides methods to query status information and to set a TFORMer Runtime license. More...

List of all members.

Static Public Member Functions

static boolean isDesignerAvailable () throws TFormerException
 Gets a value indicating whether the TFORMer Designer is available.
static void license (String sLicensee, ELicenseKind kind, int nNumberOfLicenses, String sKey) throws TFormerException
 Applies a license to this instance of the TFORMer Runtime.


Detailed Description

Provides methods to query status information and to set a TFORMer Runtime license.

Member Function Documentation

static boolean isDesignerAvailable (  )  throws TFormerException [static]

Gets a value indicating whether the TFORMer Designer is available.


This property determines whether the TFORMer Designer (TFORMer.exe) is installed on the local machine. If the TFORMer Designer is installed, form-layouts can be edited with TFORMer Designer.

The method Formlayout.design starts the TFORMer Designer and loads the current form.

Returns:
true if the TFORMer Designer is available; otherwise, false.
Exceptions:
TFormerException error occurred into TFORMer runtime.

static void license ( String  sLicensee,
ELicenseKind  kind,
int  nNumberOfLicenses,
String  sKey 
) throws TFormerException [static]

Applies a license to this instance of the TFORMer Runtime.



Once the TFORMer Runtime is licensed all restrictions of the demo version are removed. The method needs to be called prior to any call of Print()(). It is recommended to call License(String, LicenseKind, Int32, String) once immediately after loading the TFORMer Runtime.

You will receive the license information from TEC-IT Datenverarbeitung GmbH after ordering (http://www.tec-it.com/order). All license values must be specified exactly as received from TEC-IT. The license kind, the number of licenses and the licensee string are checked against the license key.

This method always licenses TFORMer for the current user because it writes the license data into the HKCU hive of the system registry.

In order to allow system-wide licensing TFORMer performs the following checks in the specified order (the first license information found will be used, TFORMer does not check if it is valid or not).

 1.  License file TFORMer.ini in the Bin directory. You must install the file yourself. It has the following format:
 

 [LICENSE_DATA] 
 License_Product=xx   ; xx specifies the licensed product: 28...TFORMer Designer, 29...TFORMer Runtime for Windows, 
                      ;                                    30...TFORMer Designer Server Edition, 107...TFORMer Runtime for Linux or UNIX
 Licensee=name        ; the name of the licensee as received from TEC-IT
 License_Kind=1       ; the number is identical to the enumeration LicenseKind 
 Number_Of_Licenses=n ; n is equal to the number of licenses
 License_Key=key      ; the key received from TEC-IT 

 2.  HKLM hive of the registry HKEY_LOCAL_MACHINE-IT Datenverarbeitung GmbH\TFORMer\6.0
     You must install this registry key yourself, if required you have to move the license key manually into this location. Use the
     command regedit to export HKEY_CURRENT_USER-IT Datenverarbeitung GmbH\TFORMer\6.0 and re-import it to
     HKEY_LOCAL_MACHINE-IT Datenverarbeitung GmbH\TFORMer\6.0.
 

 3.  HKCU hive of the registry HKEY_CURRENT_USER-IT Datenverarbeitung GmbH\TFORMer\6.0 
     This is the default location TFORMer Designer uses for licenses keys.
 

Parameters:
sLicensee The licensee.
kind The kind of the license.
nNumberOfLicenses The number of licenses.
sKey The license key.
Exceptions:
TFormerException error occurred into TFORMer runtime.


© 2006-2009 All rights reserved by TEC-IT Datenverarbeitung GmbH
Generated on Wed Sep 2 16:01:27 2009 for TFORMer Runtime JAVA Developer Reference with doxygen 1.5.8