In array mode, specifies an array of strings to be loaded into the list box. The interpretation and parsing of these strings into columns is determined by the coldef parameter. To pass the array to XTREE, you may either specify a specific starting element (e.g. ARRAY(1)) or an unformatted variable under which the array is defined (ARRAYX in the example below):

MAP1 ARRAYX               ! unformatted variable

   MAP2 ARRAY(50),S,100

 

Each array element must have at least one trailing null byte. Note that by using the overlay feature, you could support several array layouts with the same XCALL XTREE statement, i.e.

MAP1 ARRAYX2,@ARRAYX      ! overlay on ARRAYX above

   MAP2 ARRAY2(10),S,60   ! array of ten sixty byte strings

MAP1 ARRAYX3,@ARRAYX      ! yet another overlay

   MAP2 ARRAY3(80),S,8    ! array of eighty 8 byte strings

 

Any text in an individual cell (in array mode) or line (in file mode) which follows a backslash ("\") will be hidden from view (unless the cformat \ switch is specified).

In single-selection file mode, the array parameter is interpreted as an ordinary string to return the text of the selected items (all columns, but with right-justified columns stripped of trailing blanks.) If the XTF_FILANS flag is set, then array is ignored on entry; otherwise it should contain the text of the item to initially select (as returned from the prior call).

In multiple-selection file mode, the array parameter is ignored. (The selection information is passed via the array of one byte flags in the answer parameter, just as in multiple-selection array mode.)