MediaHandling.Occurrence Property

ClosedDescription

Sets or returns when a media handling action should occur. Used with the MediaHandling object to determine when actions should be triggered.

ClosedSyntax

MediaHandling.Occurrence = BtMediaHandlingOccurrence

Where BtMediaHandlingOccurrence can be any of the following constants:

ClosedRequirements

Version

BarTender 7.75 or higher

Edition

Automation, Enterprise

ClosedRemarks

The MediaHandling.Occurrence property determines when a Media Handling action will be performed. Some selections, such as btMHAfterNumberOfLabels, will require additional information (in this case, the desired number of items to print before performing the action.)

ClosedVB.NET Example

'Declare a BarTender application variable

Dim btApp As BarTender.Application

'Declare a BarTender document variable

Dim btFormat As BarTender.Format

'Declare a BarTender media handling variable

Dim btMediaHandling As BarTender.MediaHandling

'Create a new instance of BarTender

btApp = New BarTender.Application

'Set the BarTender application visible

btApp.Visible = True

'Open a BarTender document

btFormat = btApp.Formats.Open("c:\Format1.btw", False, "")

'Set the media handling variable

btMediaHandling = btFormat.PageSetup.MediaHandling

'Set the occurrence value

btMediaHandling.Occurrence = BarTender.BtMediaHandlingOccurrence.btMHAtEndOfPrintJob

'End the BarTender process

btApp.Quit(BarTender.BtSaveOptions.btDoNotSaveChanges)

ClosedC# Example

// Declare a BarTender application variable

BarTender.Application btApp;

// Declare a BarTender document variable

BarTender.Format btFormat;

// Declare a BarTender media handling variable

BarTender.MediaHandling btMediaHandling;

// Create a new instance of BarTender

btApp = new BarTender.Application();

// Set the BarTender application visible

btApp.Visible = true;

// Open a BarTender document

btFormat = btApp.Formats.Open("c:\\Format1.btw", false, "");

// Set the media handling variable

btMediaHandling = btFormat.PageSetup.MediaHandling;

// Set the occurrence value

btMediaHandling.Occurrence = BarTender.BtMediaHandlingOccurrence.btMHAtEndOfPrintJob;

// End the BarTender process

btApp.Quit(BarTender.BtSaveOptions.btDoNotSaveChanges);