[Contents] [Index] [Help] [Browse <] [Browse >]
lister set <handle> handler <port name> [quotes] [fullpath] [editing]
           [nopopups] [guage] [leaveguage] [synctraps] [subdrop]


Sets the  custom handler  port name for this lister.

 handle  is the handle of the lister in question.

 port name  is the name of the message port to which messages from Opus
will be sent.

Note that message port names are case sensitive. Make sure that you use
the correct case and that you quote the name properly so that ARexx
doesn't uppercase it.

If you specify the  quotes  flag, any filenames sent in messages to the
port will be enclosed in quotes (this is a good idea as it allows you to
support filenames containing spaces).

If you specify the  fullpath  flag, messages will always contain the full
path name of a file, irrespective of whether it came from an Opus lister or
not. (Usually, if the file comes from a lister you will only get the
filename itself, plus the lister handle with which to find out the path).

If you specify the  editing  flag, inline lister editing will be enabled
for this lister.

If you specify the  nopopups  flag, all file popups will be disabled for
this lister.

If you specify the  guage  flag, you can enable the 'Free Space Gauge'
to show the proportion of space free on the disk. (note that the user may
still have turned them off in the environment)

Specifying the  leaveguage  flag, will cause an existing fuelguage
to remain there, or leave it absent if it wasn't.  This is in contrast to
the above  guage  flag, which will always add a fuelguage.

Not providing the  guage  or the  leaveguage  will always cause a
lister to have no fuelguage.

The  synctraps  flag causes messages trapped by an ARexx lister handler
to be handled synchronously.  By default, (and for compatibility), all
handler messages remain asynchronous.

The  subdrop  flag allows handlers to use the  Drag into subdirectories 
feature of Opus.  See  Environment/Lister Options  in the Opus manual
for more information on this option.

For example,
        + lister set 121132636 handler 'lhadir_handler' quotes
        + lister set 121132636 handler 'lhadir_handler' quotes guage nopopups
        + lister set 121132636 handler 'lhadir_handler' quotes leaveguage

See  Custom Handlers  section for more details.

See also:

 lister query handler 
 Custom Handlers 


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