New (Stringlist constructor)

From m204wiki
Revision as of 14:12, 24 November 2010 by Admin (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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).