Performance.AllowFormatCaching Property

ClosedDescription

Sets and returns whether the printer will cache a printed item's formatting information between print jobs.

ClosedSyntax

Performance.AllowFormatCaching = true|false

If true, the printer will cache the formatting information between print jobs.

ClosedRequirements

Version

BarTender 7.50 or higher

Edition

Automation, Enterprise

ClosedRemarks

When used with ActiveX Automation, printer drivers from Seagull Scientific, Inc. have the ability to cache templates and graphics in a printer and reuse them during subsequent print jobs. This can significantly increase the speed of print jobs. The Performance.AllowFormatCaching property allows the printer to cache formatting information, such as object positions, font size, symbologies, and line or box colors. The printer can then retrieve from the cache any templates that are reused on later print jobs. It will not store a bitmap of the template or any objects on the template.

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

Caching does not perform well when more than one computer is printing to the same printer. Ensure in this situation that the Performance.AllowFormatCaching and Performance.AllowGraphicsCaching properties are set to false.

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 caching option

btPerformance.AllowFormatCaching = 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 caching option

btPerformance.AllowFormatCaching = true;

// Print the document

btFormat.PrintOut(false, false);

// End the BarTender process

btApp.Quit(BarTender.BtSaveOptions.btDoNotSaveChanges);