Introduction

The sample programs demonstrate how to use the C and COM implementations of HTML Export. The sample code is intended to provide a starting point for your own applications or to be used for reference purposes.

The source code and makefile for each program are in the following directory, where install is the path of the Export installation directory, and program_name is the name of the sample program:

install\htmlexport\programs\program_name

In addition to the sample programs, Micro Focus provides a reference implementation for HTML Export. For more information, see HTML Export Reference Implementation.

C Sample Programs

The C sample programs demonstrate how to use the C implementation of HTML Export. The following sample programs are provided:

You can use the tstxtract, cnv2html, cnv2htmloop, and htmlini sample programs on Windows and UNIX. All other sample programs are for Windows only.

NOTE: The sample programs do not parse white space in file names. If your file names contain spaces, use quotation marks around the entire path name. Inserting quotation marks around the file name only does not work.

The sample programs pass license information to KeyView using fpInitWithLicenseData(). This is the method recommended by Micro Focus. Before the sample programs can be compiled, you must replace the parameters YOUR_LICENSE_ORGANIZATION and YOUR_LICENSE_KEY in the fpInitWithLicenseData() function call with your license information.

To compile the sample programs, use the makefiles provided in the sample programs' directory. Ensure the HTML Export include directory is specified in the include path of the project. After the executables are compiled and built, you must place them in the same directory as the HTML Export libraries.

NOTE: Compiled binaries are provided for some of the sample programs, in the PLATFORM/bin folder. These have an embedded trial license, which expires approximately five months after release.

Compile the Visual Basic Sample Program

To compile Export Demo, use the Visual Studio project file (demo_vb.vbp) in the directory install\htmlexport\programs\ExportDemo, where install is the path of the Export installation directory. The executable is in the same directory.

COM Sample Program

The COM API is a COM interface to HTML Export and is available on 32-bit Windows platforms only. The interface is well suited for Visual Basic and Visual J++ programmers. The interface is an IDispatch interface, and can therefore be used with scripting environments such as Active Server Pages.

The following COM sample programs are provided:

To compile the Template Wizard, use the Visual Studio project file (htmvbwzd.vbp) in the install\htmlexport\programs\wizard directory, where install is the path name of the Export installation directory.

To compile the comsamp sample program, use the Visual Studio project file (comsamp.vbp) in the install\htmlexport\programs\comsamp directory.

To compile htmloop, use the Visual Studio project file (htmloop2.dsw) in the install\htmlexport\programs\htmloop directory.