Win()

Locates and returns a graphics window object given its location.

WIN() picnum=Integer winnum=Integer Absolute index of the object.

example:
	# Copy the 2nd window in the
	# last but one picture into a
	# new picture
	>> pic_add item=win(-2,2) picture=picture()
Note: A picture value of 0 specifies the current picture.

Win

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 window objects are stored within a picture, this means that to refer to a window, it is necessary to specify the index of the picture as well. If the window is in the current picture zero can be used for the "picnum" parameter.

Parameters:

Picnum (Integer)

The position within the picture list of the required picture.

Winnum (Integer)

The position within the window list of the required window.

RESULT = (Gobject)

Returns the graphics window specified.