ImageLayout Property
Determines how the labels will be formatted for printing.
Syntax
[VB.NET] Public Property ImageLayout As UspsshipintlImageLayouts
[C#] public UspsshipintlImageLayouts ImageLayout {get; set;}
enum UspsshipintlImageLayouts { ilOnePerFile, ilAllInOneFile, ilTrimOnePerFile, ilTrimAllInOneFile }
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 ShippingLabelFile is specified, these additional pages will be saved with the page number appended to the ShippingLabelFile you supplied.
For instance, if the ShippingLabelFile 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.
Default Value
0