Occurrence Tag

Sets the trigger for the media handling action.

<Occurrence>Value</Occurrence>

Where Value can be set to one of the following:

btMHAtEndOfPrintJob: Perform the action at the end of the print job.
btMHAfterEveryPage: Perform the action after every page.
btMHAfterEveryRecord: Perform the action after every record.
btMHAfterDataChange: Perform the action after a data change occurs.
btMHAfterNumberOfLabels: Perform the action after reaching a specified number of labels.
btMHAfterIdenticalCopies: Perform the action after processing identical copies of a label.

The <Occurrence> tag determines when a media handling action will be performed. Some selections, such as btHMAfterNumberOfLabels, require additional information (in this case, the desired number of labels to print before performing the action.)

<Occurrence> is an optional tag that is used with the <Print> and <FormatSetup> commands when the <MediaHandling> tag is included in the script.

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

<Print>

<Format>Label1.btw</Format>

<Action>btMHPageBreak</Action>

<DataItemName>TheDataItemName</DataItemName>

<DataItemType>btMHNamedSubString</DataItemType>

<Occurrence>btMHAfterDataChange</Occurrence>

</MediaHandling>

</Print>

</Command>

</XMLScript>

BTXML Script version 1.0 (BarTender 8.0 and later versions)

Occurrence Tag

Description

Syntax

Parent Tag

Remarks

Example

Requirements