Performance.AllowVariableDataOptimization Property

ClosedDescription

Sets and returns whether or not printers that have a merge data feature will use it for the duration of a print job.

ClosedSyntax

Performance.AllowVariableDataOptimization = true|false

If true, the printer will store formatting information for both static and variable objects.

ClosedRequirements

Version

BarTender 7.50 or higher

Edition

Automation, Enterprise Automation

ClosedRemarks

When the Performance.AllowVariableDataOptimization property is set to true, the printer will store formatting information (object positions, symbology, font name and size, line and box colors, etc.) for both static and variable objects. Only the content of the objects will have to be sent to the printer for each printed item in a print job.

If the content is also being stored by means of the AllowStaticObjects property, then only the content of variable objects will have to be sent to the printer for each item. The printer will merge this data into the appropriate fields on the item.

If the printer does not support this feature, the setting of the Performance.AllowVariableDataOptimization property is ignored.

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 print setup variable

Dim btPrintSetup As BarTender.PrintSetup

'Declare a BarTender performance variable

Dim btPerformance As BarTender.Performance

'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 print setup variable

btPrintSetup = btFormat.PrintSetup

'Select the performance variable

btPerformance = btPrintSetup.Performance

'Set the variable data optimization option

btPerformance.AllowVariableDataOptimization = True

'Print the document

btFormat.PrintOut(False, False)

'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 print setup variable

BarTender.PrintSetup btPrintSetup;

// Declare a BarTender performance variable

BarTender.Performance btPerformance;

// 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 print setup variable

btPrintSetup = btFormat.PrintSetup;

// Select the performance variable

btPerformance = btPrintSetup.Performance;

'Set the variable data optimization option

btPerformance.AllowVariableDataOptimization = True

// Print the document

btFormat.PrintOut(false, false);

// End the BarTender process

btApp.Quit(BarTender.BtSaveOptions.btDoNotSaveChanges);