VpeSetTplPageObjPaperBin

<< Click to Display Table of Contents >>

Navigation:  Template Page >

VpeSetTplPageObjPaperBin

Previous pageReturn to chapter overviewNext page

Returns the printer's input paper bin of the specified template page as defined in dycodoc.

void VpeSetTplPageObjPaperBin(

VpeHandle hPage,

int bin

)

VpeHandle hPage

Page Handle

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).

 

See Also:

"dycodoc Template Processing" in the Programmer's Manual