New (Stringlist constructor)

From m204wiki
Revision as of 21:33, 18 January 2011 by Wiccan (talk | contribs) (1 revision)
Jump to navigation Jump to search

Create new Stringlist instance (Stringlist class)


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:

Syntax

%sl = [%(Stringlist):]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).