[Contents] [Index] [Help] [Browse <] [Browse >]
lister new [<x/y/w/h>] [toolbar <toolbar>] [inactive] [invisible]
           [iconify] [mode <name|icon|action|showall>] [fromicon <path>] [<path>]

This command creates a new lister.

You may optionally specify the position and size of the new lister. The
default position of -1/-1 causes the lister to open under the mouse
pointer with the default width and height as specified by the environment.

The position is specified by the [<x/y/w/h>] parameter:

        x      - x-coordinate for top-left of lister window, or -1;
        y      - y-coordinate for top-left of lister window, or -1;
        w      - width of the lister window;
        h      - height of the lister window.

A custom toolbar for the lister can be specified with the  toolbar 
keyword; toolbar files are expected to be found in the DOpus5:Buttons 
directory if the full path is not given.

You may also specify a  path  to read when the lister opens.

Any  path  specified must occur at the end of the command line.

The initial state of a lister can be set by providing one or more of these
additional keywords:

 inactive  prevents the newly opened lister from being the active window.
 invisible  causes the lister to be invisible initially.
        See  lister set visible , and  lister query visible 
 iconify  causes the lister to start iconified.
        See  lister iconify 
 fromicon  will open the new lister using the size and position information
        from the specified directory's icon (only if a path is specified and an icon
        exists).  Eg, lister new fromicon sys:tools
 mode  lets you specify the initial mode of the new lister.
        ie. name, icon, icon action and showall

For example,
        + lister new
        + lister new 100/50/400/300
        + lister new ram:
        + lister new 80/30/200/200 dh0:work
        + lister new toolbar custom_toolbar work:
        + lister new fromicon SYS:Devs work:
        + lister new mode icon work:
        > 121132636   (Typical return from any one of the above).

If the lister opens successfully, its handle is returned in the  RESULT 
variable. You must save the value of this handle if you wish to do anything
further with this lister. In the above example, a handle of 121132636 was
returned. This is used in many of the examples.


Converted on 04 Nov 1998 with RexxDoesAmigaGuide2HTML 2.2 by Michael Ranner.