Locates and returns a picture object given its index.
| PIC() | picnum=Integer | Absolute index of the object. |
example:
# Redraw the third picture >> redraw pic(3) device=dev(2)
Note: All indices must be relative if /REL is specified.
This is one of four functions which return a reference to a graphical object when given index information about the location of the object in the graphics object subsystem ( Dev(), Pic(), Win() and Obj() ).
Positive numbers give the number of the object in its list, starting at 1. Negative numbers give the number of the object starting from the last item in the list and counting backwards, starting at -1 (this is often the easiest way to find objects). Zero represents the last object created, normally the current object.
All Open GENIE pictures are stored in a single picture list, regardless of the number of devices opened (pictures may be redrawn to one or more devices using the Redraw() command).
Picnum (Integer)
The position within the picture list of the required picture.
RESULT = (Gobject)
Returns the picture object specified.