ERRCODE TFormer_OpenDesigner ( HTFORM  pInstance,
LPCSTR  pszDesignExe,
BOOL  bShowSplash,
BOOL  bMaximize,
BOOL  bUseExistingInstance,
LPCSTR  pszExtraParameters 
)

Opens the currently selected FormLayout with TFORMer Designer.

Returns:
- ErrOk (0) in case of success
- Non-zero if error occurred
Parameters:
[in] pInstance The TFORMer-Instance provided by a previous call to TFormer_Init.
[in] pszDesignExe if NULL the function tries to locate TFORMer Designer by itself
[in] bShowSplash Show the splash screen of TFORMer Designer?
[in] bMaximize Open TFORMer Designer maximized?
[in] bUseExistingInstance Try to use an existing TFORMer Designer instance?
This parameter avoids multiple TFORMer Designer windows. A new instance of TFORMer Designer is opened if no existing instance is found or no existing instance can be used.
[in] pszExtraParameters Parameters which should be sent to TFORMer Designer (Default: NULL)
These parameters are used for branding of TFORMer Designer via the command-line (see below).
Remarks:
TFORMer Runtime on its own cannot be used for editing a FormLayout. Use this method to invoke TFORMer Designer.

  • If there is no given EXE file (parameter pszDesignExe), then this function uses a value in the System Registry ([HKCU|HKLM]\TEC-IT\TEC-IT Datenverarbeitung GmbH\6.0\TFormerApp) to determine the location of TFORMer.exe.
  • If this key is not found or the file doesn't exist, then TFORMer.exe will be searched in the directory where TFORMer Runtime is installed.
  • If TFORMer.exe is not found here too, then it will search TFORMer.exe in the current directory.
  • Finally - if TFORMer.exe was still not found it checks the complete path (environment variable PATH).
Note:
Make sure that your purchased license model fits your requirements. If you are creating applications which are distributed to 3rd party you may need to redistribute TFORMer Designer as well.

TFormer_SetFormName has to be called prior to calling this function.

For branding TFORMer Designer there are two different possibilities:

  • Provide Splash-Screen and About Box bitmaps in the same directory as TFORMer Designer is installed. The required filenames are TFSS.mbp (Splash-Screen) and TFAb.mbp (About Box)
  • Via command-line parameters (these parameters overrule the file-system):
    /Splash [SplashPicture.bmp]
    /AboutBox [AboutboxPicture.bmp]
See also:
TFormer_IsDesignerAvailable.


© 2006-2009 - all rights reserved by TEC-IT Datenverarbeitung GmbH
Generated on Wed Sep 2 16:01:09 2009 for TFORMer Runtime DLL/Shared Library with doxygen 1.5.8