Open topic with navigation

PrintSetup Tag

ClosedDescription

The PrintSetup command sets a BarTender document's print options. These options correspond to the options 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 or not the print job will print again after completing the first printing.

EnablePrompting

Optional

Sets whether or not 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 will use.

Performance

Optional

Sets performance options.

Printer

Optional

Sets the printer that is receiving the print job.

PrintToFile

Optional

Sets whether the document will be 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 will use when it saves the print job.

RecordRange

Optional

Sets the range of records that the print job will print.

StartingPosition

Optional

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

UseDatabase

Optional

Sets whether or not the print job will get 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 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 higher)