PageSetup.LabelGapManual Property

ClosedDescription

Returns or sets whether or not the size of the gaps between items on a page have priority over other PageSetup properties in the event the properties are inconsistent.

ClosedSyntax

PageSetup.LabelGapManual = true|false

If true, the gap sizes will have precedence over other size properties of the PageSetup object, in the event of conflicts.

ClosedRequirements

Version

BarTender 7.75 or higher

Edition

Automation, Enterprise

ClosedRemarks

The PageSetup.LabelGapManual property is set to true whenever the PageSetup.LabelGapVertical or PageSetup.LabelGapHorizontal properties are changed. If you do not desire this effect, you will need to reset the PageSetup.LabelGapManual property to false immediately after setting the gap sizes. For more information, see Automatic Adjustments to Page Setup Values

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

Dim btPageSetup As BarTender.PageSetup

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

btPageSetup = btFormat.PageSetup

'Let BarTender know that the gap sizes are being set manually

btPageSetup.LabelGapManual = True

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

BarTender.PageSetup btPageSetup;

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

btPageSetup = btFormat.PageSetup;

// Let BarTender know that the gap sizes are being set manually

btPageSetup.LabelGapManual = true;

// End the BarTender process

btApp.Quit(BarTender.BtSaveOptions.btDoNotSaveChanges);