MediaHandling.Occurrence Property |
Sets or returns when a media handling action should occur. Used with the MediaHandling object to determine when actions should be triggered.
MediaHandling.Occurrence = BtMediaHandlingOccurrence
Where BtMediaHandlingOccurrence can be any of the following constants:
btMHAtEndOfPrintJob: The media handling action is triggered at the end of the print job; has a value of 0.
btMHAfterEveryPage: The media handling action is triggered after every page has printed; has a value of 1.
btMHAfterEveryRecord: The media handling action is triggered after every record has printed; has a value of 2.
btMHAfterIdenticalCopies: The media handling action is triggered after all copies of an item have printed; has a value of 3.
btMHAfterDataChange: The media handling action is triggered after a specified database field, data source, or object has changed value; has a value of 4.
btMHAfterNumberOfLabels: The media handling action is triggered after a specified number of items have printed; has a value of 5.
Version |
BarTender 7.75 or higher |
Edition |
Automation, Enterprise |
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.)
'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)
// 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);