Templates > VpeSetTplPaperBin

Sets the printer's input paper bin of the specified template page.

void VpeSetTplPaperBin(

VpeHandle hTemplate,

int page,

int bin

)

VpeHandle hTemplate

Template Handle

int page

index into the array of available Pages

this value must be in the range between 0 and VpeGetTplPageCount() - 1

int bin

possible values are:

Constant Name	Value	Comment
VBIN_UNTOUCHED	-1
VBIN_UPPER	1
VBIN_ONLYONE	1
VBIN_LOWER	2
VBIN_MIDDLE	3
VBIN_MANUAL	4
VBIN_ENVELOPE	5
VBIN_ENVMANUAL	6
VBIN_AUTO	7
VBIN_TRACTOR	8
VBIN_SMALLFMT	9
VBIN_LARGEFMT	10
VBIN_LARGECAPACITY	11
VBIN_CASSETTE	14

Not all of the bin options are available on every printer. Check the printer's documentation for more specific descriptions of these options.

Remarks:

This property is independent from DevPaperBin. You should always use this function to specify the paper bin.

The value VBIN_UNTOUCHED is a VPE internal constant. It instructs VPE not to change the bin from the setting the current selected device has.

Changing the bin during the print-job doesn’t work with some (buggy) printer drivers. Changing the bin with such drivers for other pages than the very first page might not work. Most printer drivers will work.

Printer drivers are manufactured by vendors independent of IDEAL Software; we make no warranty, implied or otherwise, regarding these product’s performance or reliability.

Example:

VpeSetTplPaperBin(hTemplate, 2, VBIN_UPPER)

Will instruct the printer during printing, to print the third page (pages in the template are counted starting with zero) of the template on the upper paper bin (if available).