TFORMer SDK - NET 8
|
Install TFORMer Designer (the graphical layout editor) and TFORMer SDK (the reporting and label printing core) using the setup applications. TFORMer SDK is available as DLL, as COM component, as .NET assembly, as JAVA class and as stand-alone application (TFPrint
). Both the COM component and the .NET assembly of TFORMer SDK are registered automatically. The .NET assembly is automatically placed in the GAC
and in the Bin
directory of the installation folder. The Java package JTFORMer8.jar (which is compatible with the Java Runtime Edition - JRE version 1.5 or higher) is copied into the Bin
directory: It includes all classes that you need to create a TFORMer application with the Java language.
Use TFORMer Designer to create a FormLayout graphically. Most likely a FormLayout contains dynamic data which will be provided by your application during print-time (e.g. an article number for a product label or a ticket number for an e-ticket). TFORMer uses DataFields as place-holders for such dynamic data. These DataFields are declared as well as used within the FormLayout.
Check out the following paragraphs to learn how to print or export a FormLayout with data provided by your application!
Create a new .NET based project. In Visual Studio right-click on your project in the Solution Explorer and select Add Reference. Open the .NET tab and select TFORMer 8 SDK. Alternatively open the Browse tab and select the TFORMer .NET assembly called TECIT.TFORMer.dll
.
Add the namespace TECIT.TFORMer
in each source file that uses TFORMer SDK:
Licensing is not required for evaluation purposes. For production, apply a license key to TFORMer SDK before using any other properties or methods of TFORMer. This needs to be done only once, for example when initializing the application.
Printing is done with the help of a print Job. Create a Job and select the FormLayout by setting the appropriate properties.
As mentioned above a FormLayout usually contains DataFields which are used as place holders for dynamic data. Before printing a FormLayout you need to provide data for these DataFields by assigning suitable JobData to the Job. Various methods are available for providing JobData.
This is the most direct method to pass data to TFORMer SDK. In this case the names and values of the DataFields used in a FormLayout are provided directly. The example below sets the values for the DataFields ArticleNo
, ArticleName
and ArticlePrice
.
See also JobDataCsv
See also JobDataXml
See also JobDataOdbc
See also JobDataDataSource
Last but not least TFORMer Designer offers the possibility to specify a "user-defined" DataSource as part of a FormLayout. Such a DataSource defines how data is retrieved (e.g. from an ODBC database) and it specifies the mappings between fields in the DataSource and DataFields in the FormLayout. If you want to use such a user-defined DataSource for JobData retrieval, select the DataSource by name as shown below. Use optional DataSourceParameters to control certain aspects (like the filename, SQL SELECT statement or DSN) of the DataSource during runtime.
Use PrinterName to specify the target printer. Provide an empty string, if you want to send the output to the default printer.
Instead of printing on a printer, you can export the output as a PDF, PostScript, HTML, ASCII or image file. ZPL-II (the ZEBRA printer language) generation is supported too. Instead of setting a printer name, set the name and type of the output file.
Starting with TFORMer version 7 it is possible to generate the output as an in-memory stream. No output or temporary files are required, the performance for creating the output is dramatically improved. Currently PDF- and image-output (excluding multi-page TIFF) are generated completely in-memory.
If the output results in a single stream (this is true for Postscript, PDF, multi-page TIFF and ZPL output) use PrintToStream. If the generated output results in several streams (e.g. generating multiple labels as single PNG images) use PrintToStreams.
Although not required, you may call dispose
.
© 2006-2023 - all rights reserved by TEC-IT Datenverarbeitung GmbH | |
Generated on Thu Dec 28 2023 18:45:19 for TFORMer SDK - NET with doxygen 1.9.4 |