REQUESTFILE
Format: REQUESTFILE [DRAWER <drawer name>] [FILE <file>]
[PATTERN <pattern>] [TITLE <title>] [POSITIVE
<text>) [NEGATIVE <text>] [ACCEPTPATTERN <pattern>]
[REJECTPATTERN <pattern>] [SAVEMODE) [MULTISELECT]
[DRAWERSONLY] [NOICONS] [PUBSCREEN <public screen name>]
Template: DRAWER, FILE/K, PATTERN/K, TITLE/K, POSITIVE/K, NEGATIVE/K,
ACCEPTPATTERN/K, REJECTPATTERN/K, SAVEMODE/S, MULTISELECT/S,
DRAWERSONLY/S, NOICONS/S, PUBSCREEN/K
Purpose: To allow AmigaDOS and ARexx scripts to use the ASL file
requester.
Path: C:REQUESTFlLE
Specification:
REQUESTFILE allows AmigaDOS and ARexx scripts to use the ASL file requester.
The DRAWER argument specifies the initial contents of the Drawer gadget
The FILE option specifies the initial contents of the File gadget.
The PATTERN option allows the use of a standard AmigaDOS pattern. It
specifies the initial contents of the Pattern gadget. If this option is not
provided, the file requester will not have any Pattern gadget.
The TITLE option specifies the title of the requester.
The POSITIVE option specifies the text to appear in the positive (left)
choice in the file requester.
The NEGATIVE option specifies the text to appear in the negative (right)
choice in the file requester.
The ACCEPTPATTERN option specifies a standard AmigaDOS pattern. Only files
matching this pattern will be displayed in the file requester.
The REJECTPATTERN option specifies a standard AmigaDOS pattern. Files
matching this pattern will not be displayed in the file requester.
If SAVEMODE is specified, the requester will operate in save mode. If
MULTlSELECT is specifed, the requester will allow multiple files to be
selected at once. If DRAWERSONLY is specifed, the requester will not have a
File gadget. This effectively turns the file requester into a directory
requester. If NOICONS is specified, the requester will not display icons
(.info files).
The selected files are returned on the command line, enclosed in double
quotes and separated with spaces. The command generates a return code of 0
if the user selected a file, or 5 if the user cancelled the requester.
REQUESTFILE is valid on Workbench 3.0 level software.
Converted from AmigaGuide to HTML by Jaruzel