GetImage (Stringlist subroutine)

Retrieve Stringlist item into image (Stringlist class)

This method copies data from a specified Stringlist item to an image.

Syntax

sl:GetImage( itemNum, [imageName])

Syntax terms

sl	A Stringlist object.
itemnum	The number of the item in the Stringlist.
imagename	A string that contains the name of an image. This is an optional argument if an image has been associated with the Stringlist with a BindImage method (BindImage (Stringlist function). Otherwise, it is a required argument. This argument is case sensitive. That is, in the likely event the User Language was written in mixed case, with automatic uppercasing in effect (see Mixed-case User Language, the image name should be in uppercase.

Usage notes

• All errors in GetImage result in request cancellation.
• One way to extract a Stringlist item into an image (called Headstone, below) is as follows:

  %list:getImage(%n, 'HEADSTONE')

  Here is a neater and more efficient way of doing this:

  %list:bindImage('HEADSTONE') . . . . . . %list:getImage(%n)

  In this last example, the BindImage (Stringlist function) associates the image with the Stringlist, eliminating the need to specify the image name on the GetImage.

See also

Stringlist class	List of Stringlist methods	Stringlist methods syntax
Notation conventions for methods