Lister New

back to section start!

 ArcDir 

  The first lister command we'll look at is  lister new .  This command
let's you open a new lister, allowing you to specify it's position, size,
initial path, toolbar, status, mode, etc.

  The default position for a lister to open is under the mouse, and if no
path is specified then the lister will be empty.

   An important thing to note is that any PATH you specify must occur
                    at the end of the command line.

  In the following  lister new  examples, the listers will close after
5 seconds.

Examples:

/* DOpus lister new */
options results
address 'DOPUS.1'
 lister new mode name              /* open name mode lister, no initial path */
 lister new mode icon SYS:         /* open icon mode lister, with path of SYS: */
 lister new mode icon action SYS:  /* open in iconaction mode, with path of SYS: */
 lister new mode showall RAM:      /* open icon mode lister showing all files */
 lister new 1/1/200/300            /* open a lister in the top left corner */
 lister new toolbar 'file://localhost/DOPLUS:Tutorial/ARexx Tutorial/TuteRexx/ListerNew.tb'   /* Use a different toolbar */
 lister new iconify RAM:           /* opens a lister, iconified */
exit

  Click on the buttons above to see the appropriate lister open.

  Any lister you open, will have a handle.  This is a number that points
to that specific lister out of however many you have open.  You will need
the handle for any further operations you want to perform on that lister.

  This handle is returned in  RESULT  when you open a lister in ARexx.

  Example:


 /* ListerHandle.dopus5 */ 
options results
address 'DOPUS.1'
dopus front
lister new
text = "Lister handle is: "result
dopus request '"'text'" OK'
lister close handle
dopus back
exit

DOpus PLUS - giving you that bit extra...