GetDevEntry

<< Click to Display Table of Contents >>

Navigation:  Device Control Properties >

GetDevEntry

Previous pageReturn to chapter overviewNext page

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

After calling DevEnum(), you are able to retrieve the names of all printing devices installed on the system with this method. With each call you retrieve one entry.

method string VPE.GetDevEntry(

long Index

)

long Index

must be in the range between 0 and the value returned DevEnum() - 1

Returns:

The name of the device specified by "index".  If index is out of range, an empty string ("") will be returned.

Remarks:

This method works only correctly, if you called DevEnum() before.

Example:

long i, count

string s

count = DevEnum() - 1        // initialize enumeration

for i = 0 to count

 s = DevEntry(i)

 MessageBox(s) // show each available device in a separate message box

next i

 

Note:

Do not call DevEnum() repeatedly, because each time VPE will query all printers from the system.

 

Wrong Example:

long i

string s

for i = 0 to DevEnum() - 1

 s = DevEntry(i)

 MessageBox(s) // show each available device in a separate message box

next i