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