ImageLayout Property
Determines how the labels will be formatted for printing.
Syntax
__property TibxUSPSShipIntlImageLayouts ImageLayout = {read=FImageLayout, write=FSetImageLayout, default=0};
enum TibxUSPSShipIntlImageLayouts { ilOnePerFile=0, ilAllInOneFile=1, ilTrimOnePerFile=2, ilTrimAllInOneFile=3 };
Default Value
0
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