New (Stringlist constructor): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (1 revision)
Line 3: Line 3:
This method returns a new instance of a <var>Stringlist</var>.
This method returns a new instance of a <var>Stringlist</var>.


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:
<var>New</var> 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==
==Syntax==
Line 17: Line 17:
==Usage notes==
==Usage notes==
<ul>
<ul>
<li>All errors in New result in request cancellation.
<li>All errors in <var>New</var> result in request cancellation.
<li>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:
<li>Specifying an image name on the <var>New</var> method is identical to using a simple <var>New</var> with no parameters followed by a BindImage method on the new object:


<pre>
<pre>

Revision as of 16:12, 19 January 2011

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