AddImage (Stringlist function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (1 revision)
Line 1: Line 1:
{{Template:Stringlist:AddImage subtitle}}
{{Template:Stringlist:AddImage subtitle}}


This callable method copies data from an image to a <var>Stringlist</var>. The AddImage method accepts one argument and returns a numeric result.
This callable method copies data from an image to a <var>Stringlist</var>. The <var>AddImage</var> method accepts one argument and returns a numeric result.


==Syntax==
==Syntax==
Line 20: Line 20:


==Examples==
==Examples==
The following example demonstrates how AddImage might be used:
The following example demonstrates how <var>AddImage</var> might be used:


<pre>
<pre>
Line 56: Line 56:
</pre>
</pre>


In this last example, the [[BindImage (Stringlist function)]] associates the image with the <var>Stringlist</var>, eliminating the need to specify the image name on the AddImage invocation.
In this last example, the [[BindImage (Stringlist function)]] associates the image with the <var>Stringlist</var>, eliminating the need to specify the image name on the <var>AddImage</var> invocation.


[[Category:Stringlist methods|Addimage function]]
[[Category:Stringlist methods|Addimage function]]

Revision as of 16:11, 19 January 2011

Add image as new Stringlist item (Stringlist class)


This callable method copies data from an image to a Stringlist. The AddImage method accepts one argument and returns a numeric result.

Syntax

[%number =] sl:AddImage[( [imageName])]

Syntax terms

%number A numeric variable to contain the number of items in the indicated Stringlist after the string has been added to the Stringlist. %rc is also the item number associated with the added string in the Stringlist.
sl A Stringlist object.
imageName A string that contains the name of an image or of any image item from the required image. This argument is optional if an image has been associated with the Stringlist by a BindImage (Stringlist function). Otherwise, it is a required argument.

Usage notes

All errors result in request cancellation.

Examples

The following example demonstrates how AddImage might be used:

image cust
name is string len 20
ssn is string len 10
bdate is string len 8
end image
...
find records to %recset
name = smith
end find
...
%list is object stringList
%list = new

for each record in %recset
%cust:name = name
%cust:ssn = ssn
%cust:bdate = bdate
%count = %list:addImage('CUST')
end for

A more efficient way of coding the For Each Record Loop is:

%list:bindImage('CUST')
for each record in %recset
%cust:name = name
%cust:ssn = ssn
%cust:bdate = bdate
%count = %list:addImage
end for

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