Syntax:
pictureHandle& = picture
Description:
This function returns a handle to the picture recorded with the most recent pair of picture on/picture off
statements. This handle is the same handle returned by:
picture off, pictureHandle&
You can specify this handle in the picture
statement when you want to draw the picture. You can also pass the picture handle to any of a number of Toolbox routines which require a picture handle as a parameter.
Note:
Your program is responsible for releasing the memory occupied by pictures created with the picture on/picture off
statements. You should normally use the kill picture
statement to do this, once you're finished using the picture handle. However, if you turn the picture into a resource (using the Toolbox routine AddResource
or PG's FNpGreplaceRes
) then you should not dispose of the picture.
See Also:
picture on/off; picture statement