Performance.AllowGraphicsCaching Property

ClosedDescription

Sets and returns whether or not the printer will cache graphics and unchanging text areas that use TrueType or OpenType fonts that have not been downloaded to the printer.

ClosedSyntax

Performance.AllowGraphicsCaching = true|false

If true, the printer will cache graphics and unchanging text areas that use TrueType or OpenType fonts.

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.

If the printer does not support this feature, the setting of the Performance.AllowGraphicsCaching 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 graphics caching option

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

btPerformance.AllowGraphicsCaching = true;

// Print the document

btFormat.PrintOut(false, false);

// End the BarTender process

btApp.Quit(BarTender.BtSaveOptions.btDoNotSaveChanges);