Settings: Options Tab

Click on the image tabs below to read information about other different configuration options.



All the following options are written under the [OPTIONS] section in the HTMLPrint initialization file.
Some of the settings can have only two possible values: 0 (OFF) or 1 (ON).
When a value is shown for any option (in the first column below), it is the default value.
The options can be set either through the above settings window, or by writing directly in the initialization file the corresponding values.





Each printer is identified either by its name or with a number between 0 and the number of installed printers -1. So if there are 4 printers the printer number may be 0, 1, 2 or 3.

When Use the default printer is selected, the Printer option will be set to -1, but when any printer is selected in the list that shows the System printers, its name will be set as Printer option.

If the printer name field is left blank the default printer will be used (Printer value will be -1).

When a printer is selected, its name will be used to set the Printer option.


Since the printer to be used by HTMLPrint can be set either by number or by name (or partial name), it is important to not use numbers to identify printers by name, to avoid ambiguity.

Example: If a printer is named "HP LaserJet 8150" and you want to set it by partial name, do not write 8150 as partial name, because HTMLPrint will try to use the printer number 8150. But if you write "Jet 8150", there will be no problem; because there are several letters in the name HTMLPrint will know that has to set the printer by name, not by number.


To see the printer names and values in your system, start HTMLPrint and scroll down to the bottom of HTMLPrint welcome screen, there you will see the list of printers in your system along with their numerical values.
Printers may also set by name, in such case DefPrinter should have the printer name, instead its value.

If UseDefaultPrinter is ON, no matter which printer is selected by Printer, the default system printer will be used.

PartialNameMatching is used to select a printer without writing its full name. When this option is ON with writing only a few letter that identify uniquely a printer (like writing PDF to select Adobe PDF) is enough to select the printer. When more than a printer with those letters if found, the first one in the list (the one with smaller number) will be the selected one.


Sets how many copies are printed.


Collate arranges the printed pages in their proper sequence when printing several sets of copies.


The images will be printed only if PrintImages is ON.


Corresponds to the Print Scale option. The printing scale can be set between 10 and 500%. By default it is 100%.


If PrintMonochromeBlack is ON, monochrome printers will always print black.  It  is set to ON by default since some monochrome printers apparently will not print anything but black.


PrintTableBack regulates table cell color background printing. By default background colors are not printed.
the page background never will be printed.

PrinterPaperSize =

Both PrinterBin and PrinterPaperSize can be set by specifying a part of the full name.
Example: Setting the paper size to ’r;A4' is the same than ’r;A4 210 x 297’).
If the text appears in more than 1 printer, the first printer with the matching subtext will be selected.


To set the printer orientation assign a value of P (for portrait) or L (for landscape). The default value is blank, so no orientation at all is set and the actual printer orientation is used.


If SetPrinter is ON (Set Printer Manually) a Printer configuration dialog will be opened before the printing starts to select the printer manually. Also HTMLPrint will be visible.


Print Filename instead Title may be useful when using printer drivers that generate files instead actually printing. If this option is unselected the file will be named accordingly to the document title, otherwise it will have the same filename than the document, but with different file extension.



Delay between printing files:

TypeOfDelay can be 0 (None), 1 (Max. num. sp. jobs) or 2 (Milliseconds):

  • None: there will be no delay between printing different files.

  • Max. number of spooler jobs: The next file in the list of files to be printed or in the directory, will be printed only after the number of printing jobs in Windows spooler is equal or less than the value assigned to Delay.

  • Milliseconds: The next file will be printed only after the specified lapse of milliseconds passed since the previous job was sent to the printer or, when printing files one at a time (passing the file name in the command line), the delay value will be the time that the printing job will wait before being sent to the printer.

Therefore, according to the type of delay specified, the value assigned to Delay will indicate either the number of jobs in Windows spooler or milliseconds.

Delay can have any value between 0 and 99999.


Default = 0 (use printer settings)

Simplex = 1

LongEdge = 2

ShortEdge = 3



RemovePathFromImages is useful if all the images are in the same directory than the HTML file, but the images references point to another paths.



Only if DownloadOnlineImages  is ON online images will be downloaded and printed but only if the images are real files on your website.

ReadTimeout indicates the number of milliseconds that the connection should wait for the image become readable.
Images are downloaded synchronously, therefore a high timeout value (if the Internet connection is slow or is not working) will delay the printing work.
If an image can't be downloaded or the timeout value is exceeded an entry will be written to the error log.


If PrintPreview is ON, when a filename for printing is passed to HTMLPrint in the command line, it will show the preview window before printing.