DevEnumPaperBins

<< Click to Display Table of Contents >>

Navigation:  Device Control Properties >

DevEnumPaperBins

Previous pageReturn to chapter overviewNext page

[Windows platform only; not supported by PHP and the Community Edition]

Initialize enumeration of all available paper bins for the currently selected output device. After this function has been called, you can retrieve each single Paper Bin name with the method GetDevPaperBinName().

method long VPE.DevEnumPaperBins(

)

Returns:

the number of available paper bins of the currently selected output device

Remarks:

In case of an error, LastError is set to VERR_COMMON. An error may occur if the device does not support multiple paper bins.

 

Do not call DevEnumPaperBins() in a loop like "for x = 0 to DevEnumPaperBins() - 1", because each time VPE will check for all available devices, which is time-consuming. Rather assign the value of DevEnumPaperBins() to a variable.

 

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

Example:

see GetDevPaperBinName()