New (Stringlist constructor)

Create new Stringlist instance

This method returns a new instance of a Stringlist.

New is a constructor and as such can be called with no object, with an explicit class name, or with an object variable, even if that object is null:

New is a member of the Stringlist class.

New Syntax

%sl = new
%sl = %(Stringlist):new
%sl = %sl:new

%sl = New([imagename])

Syntax Terms

%sl

A Stringlist object that is set to a new Stringlist object reference.

imagename

A string that contains the name of an image to be "associated" or "bound" to the %sl Stringlist. This is an optional argument. This argument is case sensitive. That is, in the likely event the User Language was written in mixed case, with automatic upper-casing in effect, the image name should be in uppercase (see Mixed-case User Language.

Usage Notes

• All errors in New result in request cancellation.
• Specifying an image name on the New method is identical to using a simple New with no parameters followed by a BindImage method on the new object:

  %list = new('IMAGENAME')
  

  is equivalent to

  %list = new
  %list:bindImage('IMAGENAME')
  

  For more information about the association or binding of an image to a Stringlist, see Bindiamge (Stringlist function).