f-req v1.7 (C) 2006-2008 Lorence Lombardo.
What the  #$% is f-req ?
f-req is an "OS3.x RequestFile" like program for 1.x, 2.x, 3.x+.
It might even work fine on MOS and OS4.
Those of you who are familiar with "OS3.x RequestFile" will be familiar
with f-req's usage.
f-req's usage is as follows:-
TITLE, FILE, DRAWER, DRAWERSONLY, PATTERN, MULTISELECT, PUBSCREEN, UNIX
SCRIPT, VOLUMESONLY, NOASSIGNS, NODISKS, CHOICE, STRING, LONG, LONGRANGE
MODEID, HIDE, NAME, HEX, 0X, INFO, MOUSE, TOPLEFT
TITLE title_text
This allows you to enter the text string that will appear in the title
bar of the window.
FILE filename
The "filename" will be the selected default file.
DRAWER dir
The first directory listing will be the specified "dir", and this path
will appear in the drawer gadget of the file requestor.
DRAWERSONLY
Will not show any filenames, only the directory names.
PATTERN pat
This keyword causes only the files which match that pattern you specify
to show up. The user can, however, enter any file he desires by simply
entering the filename or by changing the pattern.
MULTISELECT
Lets the user select multiple files. These files will be outputed to the
console device, seperated by spaces, when the 'OK' button is selected.
PUBSCREEN screenname
Lets you choose which screen you want the requestor to show up on.
This option and will be ignored under "OS1.x".
UNIX
This keyword causes the output paths to be Unix style. In some scripts
it will be necessary to obtain Amiga paths first and then convert to
Unix. In this case see the archive "a2u.lha" from the aminet.
SCRIPT script_name
Due to limitations in "OS1.x's" environment variables, this option should
be of special interest to "OS1.x" users. This keyword causes the selected
file(s) to be a part of a temporary script which will execute a specified
".key" script and pass the file name(s) to that script.
eg. f-req >t:temp_script SCRIPT script_name
"t:temp_script" will look like this:-
execute "script_name" "selected_file"
This option has been intended to be used in a pathed environment.
VOLUMESONLY
This keyword causes only Disk and Assign names to be shown.
NOASSIGNS
This keyword causes Assign names not to be shown.
NODISKS
This keyword causes Disk names not to be shown.
CHOICE body_text [button1|button2|etc...]
This keyword causes f-req to behave like "OS3.x RequestChoice".
If this is not the last keyword then a button name should be supplied.
STRING body_text [default_string]
This keyword is similar to the "CHOICE" keyword, except that it will be
a string requestor instead. If an empty string (="") is supplied to the
"body_text" then the requestor will not have a message part. If this is
not the last keyword then a default string should be supplied, use an
empty string for no default string.
LONG body_text [default_value]
This keyword is similar to the "STRING" keyword, except only a value can
be entered. If this is not the last keyword then a default value should
be supplied, use an empty string for no default value.
LONGRANGE body_text minimum maximum [default_value]
This keyword is like the "LONG" keyword, but imposes limits on the
minimum and maximum number entered. If this is not the last keyword then
a default value should be supplied, use an empty string for no default
value.
MODEID
This keyword causes f-req to open a screen mode requestor. The default
output ID will be in decimal format.
This option is not available to "OS1.x" users.
HIDE
This keyword causes non standard screen modes to be hidden.
NAME
This keyword causes the output to use the screen mode name instead
of its ID.
HEX
This keyword causes the output ID to be in hexadecimal format.
0X
This keyword causes the output ID to be in "C" style hexadecimal
format.
INFO
This keyword causes all known information about the screen mode to be
the output.
MOUSE
This keyword causes the requestors location to be at the location of the
mouse pointer.
TOPLEFT
This keyword causes the requestors location to be at the top left of the
screen.
f-req will return an empty string (="") upon cancelation, except for when
the MODEID keyword is used then the word "quit" will be returned.
For all requestors having a "body_text" a "*N" can be used to obtain a
new line.
When writing scripts to work on "OS1.x" also it is recommended that you
provide all optional parameters.
See the archive "LHA_HD_Install.lha" on the aminet for an example of a
script using f-req.
See the archive "ReqToolsUsr.lha" on the aminet for more information about
the "reqtools.library".
Distribution:
Please distribute f-req with this documentation or alternatively give
reference to the "f-req.lha" archive from the aminet within your own
documentation.
Feeling bored ? :)
Why not check out this URL ?
http://home.iprimus.com.au/lombi/1/homepage.htm
|
