Print Options

Table of advanced print options supported by setOptions.

Overview

setOptions allows to specify additional printing options. The options are specified as a string containing named values in the form [OptionName]=[value]. Multiple options are delimited by white-spaces. Values containing spaces need to be enclosed by " or ' ([OptionName]='value 1'). If values contain ", ' or \ characters, they need to be escaped with \, like \', \" and \\ ([OptionName]='\", \' and \\ need to be escaped').

List of Supported Options

Option	Output Type	Description
media	Win32 Printers	The value has to match an existing printer form name
	Other Printers	The value has to match a predefined media name or has to be specified in the format Custom.WidhtxHeight e.g. Custom.220mmX10cm
mediasource	Win32 Printers	Either the name (mediasource="Tray 2") or the id (mediasource=260) of an existing tray
	Other Printers	No effect
resolution	Image, HTML and ZPL Printers	Value in dpi (dots per inch)
	Other Printers	No effect
orientation	All Printers	Landscape Portrait
duplex	Win32 printers PostScript File/Printer	Vertical, Yes, True or 1 for vertical duplex printing Horizontal for horizontal duplex printing Simplex, None, No, False or 0 for no duplex printing
	Other Printers	No effect
collate	Win32 printers PostScript File/Printer	Option has no effect if SimulateCopies is true otherwise Yes, True or 1 for collating output No, False or 0 for not collating output
	Other Printers	No effect
copies	All Printers	The value specifies the number of copies
simulatecopies	Win32 printers PostScript File/Printer	Yes, True or 1 specifies that TFORMer will simulate copies No, False or 0 specifies that the printer driver should handle copies
	ZPL Printers	Yes, True or 1 specifies that TFORMer will simulate copies (collated) No, False or 0 specifies that the printer driver should handle copies (not collated)
	Other Printers	This option is ignored, copies are always simulated (collated)
barcode-error		abort, abort printing if an error occurs ignore, ignore the error and continue printing print, print the error information instead of the component
image-error		abort, abort printing if an error occurs ignore, ignore the error and continue printing print, print the error information instead of the component
expression-error		abort, abort printing if an error occurs ignore, ignore the error and continue printing print, print the error information instead of the component
unicode-font-error		abort, abort printing if an error occurs ignore, ignore the error and continue printing print, print the error information instead of the component
soft-hyphens		Specifies the optional soft-hyphen characters (comma separated).
hyphen		Specifies the hyphen character which should be printed when a word-break is triggered by a soft-hyphen.
offsetX		Specifies the horizontal offset of the top left corner (shift right: offsetX=3.2mm). Default unit is mm, if required you can specify other units like in, cm, m, mil, etc. (see TFORMer Designer).
offsetY		Specifies the vertical offset of the top left corner (shift down: offsetY=3.2mm). Default unit is mm, if required you can specify other units like in, cm, m, mil, etc. (see TFORMer Designer).
rotation		Specifies the additional counter-clockwise output rotation in steps of 90 degrees (will be added to the rotation of the form).
SavePersistentSerials		Yes, True or 1 specifies that TFORMer will save the values of persistent serials. No, False or 0 specifies that persistent serials will not be saved. This option is usually used for implementing preview functionality.
header	ZPL Printers	Commands sent to printer at job beginning (Sample: header="^XA^MMC^XZ" to set print mode to cutter).
	Other Printers	No effect
footer	ZPL Printers	Commands sent to printer at job ending.
	Other Printers	No effect
zpl-compression	ZPL Printers	none, rle or png specifies the image compression for graphics embedded in ZPL.
	Other Printers	No effect
ignore-undefined-fields		Specifies if undefined fields are ignored by Job.print when using JobDataRecordSet. Yes, True or 1 to ignore undefined fields No, False or 0 (Default) to return an error if field name is unknown
tbarcode-drawing-mode	Only Win32 Printers	Specifies the method for printing barcodes on Win32 printers. default, default method compatible, use the GDI rectangle functions to draw bars. May result in sub-optimal output quality, but is compatible to all printers. quality, best quality. Supported by most printers. dual, combination of compatible and quality
transparent-image-drawing-mode	Only Win32 Printers	Specifies the drawing method for printing transparent images on Win32 printers. This is an advanced option to avoid printer-driver specific problems. default, default method auto, tries to determine best method TransparentBlt, use TransparentBlt mthod MaskBlt, use MaskBlt BitBlt, use combination of BitBlts, needs access to device pixels Opaque, ignore transparency and print image opaque
font-linking		Specifies if font linking is allowed. Default yes. If a character is not supported by given font, tformer tries to find a font that will provide the needed character glyph. Yes, True or 1 (Default) for font linking No, False or 0 do not use font linking
font-substitution		Specifies if font substitution is allowed. Default yes. Yes, True or 1 (Default) tformer tries to find fallback font for unknown fonts No, False or 0 (Default) do not use font substitution
layout		Specifies an option string to modify layout settings when printing. Available options are: rows, row-height, row-spacing, columns, column-width, column-spacing, margins All options but margins support the value auto. Margins can be specified by using a container or a simple value. E.g. margins=2cm or margins={left=1cm right=2cm top=1cm botttom=2cm}
zugferd-xml	Only ZUGFeRD PDF Printer	Specifies the required ZUGFeRD-invoce.xml file that should be attached to ZUGFeRD PDF/A-3 output.
document-creator	PDF Printer PostScript File/Printer HTML File	Specifies a custom document creator (default: tfProductName - tfProductVersion).
	Other Printers	No effect
document-producer	PDF Printer HTML File	Specifies a custom document producer (default: TEC-IT Datenverarbeitung GmbH (www.tec-it.com)).
	Other Printers	No effect
document-title	PDF Printer PostScript File/Printer HTML File	Specifies the document's title.
	Other Printers	No effect
document-author	PDF Printer HTML File	Name of the person who created the document.
	Other Printers	No effect
document-subject	PDF Printer HTML File	Specifies the subject of the document.
	Other Printers	No effect
document-keywords	PDF Printer HTML File	Specifies keywords associated with the document.
	Other Printers	No effect