Open topic with navigation

PrintSetup Tag

ClosedDescription

The PrintSetup command sets a BarTender document's print options. These options correspond to the options that are available on the Options mini-tab of the Print tab.

ClosedSyntax

<PrintSetup>...</PrintSetup>

ClosedChild Elements

The following child element tags are supported.

Tag

Required/Optional

Description

AutoPrintAgain

Optional

Sets whether the print job is printed again after the first printing is finished.

EnablePrompting

Optional

Sets whether to enable the data entry form for the print job.

IdenticalCopiesOfLabel

Optional

Sets the number of copies of the document to be printed.

NumberSerializedLabels

Optional

Sets the number of serialized numbers in the print job.

PaperTray

Optional

Sets the paper tray that the print job uses.

Performance

Optional

Sets performance options.

Printer

Optional

Sets the printer that is receiving the print job.

PrintToFile

Optional

Sets whether the document is printed to a file.

PrintToFileLicense

Optional

Sets the print license that is used to print the document to a file.

PrintToFileName

Optional

Sets the file name that BarTender uses when it saves the print job.

RecordRange

Optional

Sets the range of records that the print job prints.

StartingPosition

Optional

Sets the starting print position when there are multiple columns and/or rows on a document.

UseDatabase

Optional

Sets whether the print job retrieves data from a database.

ClosedParent Tag

<FormatSetup>
<Print>
<ExportPrintPreviewToImage>

ClosedRemarks

<PrintSetup> is an optional tag that is used with the <FormatSetup>, <Print> and <ExportPrintPreviewToImage> commands.

ClosedExample

This example demonstrates the <PrintSetup> tag that is contained within the <Print> command. The <PrintSetup> tag can also be contained within the <FormatSetup> and <ExportPrintPreviewToImage> commands.

<?xml version="1.0" encoding="utf-8"?>

<XMLScript Version="2.0" Name="09232006_103601_Job1" ID="123">

<Command Name="Job1">

<Print>

<Format>Document1.btw</Format>

<PrintSetup>

<NumberSerializedLabels>50</NumberSerializedLabels>

<IdenticalCopiesOfLabel>2</IdenticalCopiesOfLabel>

<Printer>HP LaserJet</Printer>

<AutoPrintAgain>true</AutoPrintAgain>

<EnablePrompting>true</EnablePrompting>

<RecordRange>1-5</RecordRange>

<UseDatabase>true</UseDatabase>

<PaperTray>Tray1</PaperTray>

<Performance>

<AllowFormatCaching>true</AllowFormatCaching>

<AllowGraphicsCaching>true</AllowGraphicsCaching>

<AllowSerialization>true</AllowSerialization>

<AllowStaticGraphics>true</AllowStaticGraphics>

<AllowStaticObjects>true</AllowStaticObjects>

<AllowVariableDataOptimization>false</AllowVariableDataOptimization>

<WarnWhenUsingTrueTypeFonts>true</WarnWhenUsingTrueTypeFonts>

</Performance>

</PrintSetup>

</Print>

</Command>

</XMLScript>

ClosedRequirements

BTXML script version 1.0 (BarTender 8.0 and later versions)