ImageLayout Property

Determines how the labels will be formatted for printing.

Syntax

property ImageLayout: TibxuspsshipintlImageLayouts;



TibxuspsshipintlImageLayouts = (
  ilOnePerFile, 
  ilAllInOneFile, 
  ilTrimOnePerFile, 
  ilTrimAllInOneFile
);

Default Value

ilOnePerFile

Remarks

The LabelImageType property indicates the file type of the label that USPS returns. ImageLayout dictates how the label looks in that file. The labels returned by USPS measure 8.5" x 5.5", or exactly one half of a sheet of regular 8.5" x 11" paper. The layouts available are listed below:


ilOnePerFile (0)	Each label is returned as a separate file. The label takes up the top half of the paper, and the bottom half is left blank.
ilAllInOneFile (1)	All the labels are returned in one file. Each label takes up the top half of a piece of paper, and the bottom half is left blank.
ilTrimOnePerFile (2)	Labels are returned two to a file. If there are six pages of labels, then there will be only three files. Each file has a label on both the top and bottom half of the paper.
ilTrimAllInOneFile (3)	All the labels are returned in one file. No blank space is left on the pages.

For the ilAllInOneFile and ilTrimAllInOneFile ImageLayouts, only one file will be written. However, for the ilOnePerFile and ilTrimOnePerFile ImageLayouts, more than one shipping label may be returned, up to a maximum of 6 total pages. If PackageShippingLabelFile is specified, these additional pages will be saved with the page number appended to the PackageShippingLabelFile you supplied.

For instance, if the PackageShippingLabelFile is "c:\expresslabel.pdf", the following files will be created: "expresslabel.pdf", "expresslabel.page2.pdf", "expresslabel.page3.pdf", etcetera.

Note that for the stUSPSFirstClass ServiceType, only ilOnePerFile and ilAllInOneFile are supported. Using any of the Trim-values will result in an error from USPS.

Data Type

Integer