Open topic with navigation

PrintToFileName Tag

ClosedDescription

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

ClosedSyntax

<PrintToFileName [MakeUnique=true/false] [SelectAtPrintTime=true/false]>...</PrintToFileName>

Where ... is replaced with the name and path of the print file.

The supported attributes include the following.

Attribute

Required/Optional

Description

MakeUnique

Optional

When set to true, specifies that when a file exists that has the same path and file name as the file that is being saved, a serialized number is appended to the file name for the new file. When set to false, the new file overwrites the existing file. Valid options are true or false. The default is true.

SelectAtPrintTime

Optional

When set to true, displays a dialog at print time in which the print operator can specify a path and file name to save the output file. Valid options are true or false. The default is false.

ClosedParent Tag

<PrintSetup>

ClosedRemarks

<PrintToFileName> is an optional tag that can be used within the <PrintSetup> tag of a <Print> command.

ClosedExample

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

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

<Command Name="Job1">

<Print>

<Format>Document1.btw</Format>

<PrintSetup>

<Printer>PDF</Printer>

<PrintToFileName MakeUnique="true" SelectAtPrintTime="false">C:\Example\test.pdf</PrintToFileName>

</PrintSetup>

</Print>

</Command>

</XMLScript>

ClosedRequirements

BTXML Script version 1.0 (BarTender 8.0 and later versions)