HTMLPrint configuration file

When HTMLPrint is installed, a default configuration file, named HTMLPRINT.INI will be created in HTMLPrint directory (filenames are shown here in all uppercase fashion to distinguish them clearly, but using lower or uppercase doesn't matter).

The configuration file has a name similar to HTMLPrint, only the file extension is different (.INI instead .EXE). The reason is that HTMLPrint by default uses the configuration file that is named after it, if found in its own directory.

In fact, unless it is configured in other way or renamed, HTMLPrint will always use the configuration file named HTMLPRINT.INI.

Now, if you rename HTMLPRINT.EXE to OTHERNAME.EXE, HTMLPrint will try to load the OTHERNAME.INI configuration file instead HTMLPRINT.INI,so after renaming HTMLPrint, do not forget to rename consequently the configuration file.

Also, since HTMLPrint stores its activation information in the configuration file, it will be deactivated if it doesn't find the default configuration file (no matter if it is configured to use any other file). Since the default configuration file is always saved in HTMLPrint directory, when entering the activation key HTMLPrint should run with Administrator privileges when it is activated (only the first time it runs), otherwise it would not be able to rewrite the configuration file as needed, because files in the Program Files directory cannot be modified without administrative Privileges.

 

Configuration files can be edited, created, loaded and saved by using the Edit, Load and Save As commands, under the File > Configuration file menu.

 

Besides storing the activation key, the configuration file is used to set all printing options. It can be edited easily using HTMLPrint (use the File > Configuration File > Edit menu) or with any text only editor like Notepad. The file always should be saved as an only text (ASCII) file with .ini file extension.

Although the program usually looks for a configuration file with its same filename (but with .ini file extension) situated in its same directory, it is possible to use other configuration file, passing the filename as the second argument in the command-line.

The .ini file text format is the standard way for Windows applications to store and retrieve application settings. An .ini file stores information in logical groupings, called "sections". Within each section, actual data values are stored in named keys.

Keys take the form:

<keyname>=<value>

Write the key values after the equal sign (=).

Some of the settings can have only two possible values: 0 (OFF) or 1 (ON) but other settings include color or text values or file names.

 

When started without passing any parameters in the command-line, HTMLPrint always tries to load the default configuration file.

 

See Overview to know how to pass a non default configuration file in the command-line to HTMLPrint.

Configuration files can be also used in Printing Lists to change the configuration settings for groups of files in the printing list.

 

Note for Windows Vista/7/8: When editing the default configuration file, if it is stored in a non writable directory, like one inside c:\Program Files (x86), when not running as Administrator HTMLPrint will not be able to save the file in that directory, but Windows Virtualization mode will take care of saving the file transparently.

 

To know about the all available configuration settings please read the description of the tabs where the options are set:

Settings: Options Tab

Settings: Margins Tab

Settings: Footer/Header Tab

Settings: Metafile/Directory Tab

Settings Font Tab