Changes between Version 4 and Version 8 of Documentation/ARexxAPI/REQUESTFILE


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/ARexxAPI/REQUESTFILE

    v4 v8  
    1 [[TranslatedPages]]\\
    2 [[TOC(titleindex, heading=ARexx API, notitle, depth=2, Documentation/ARexx API/*)]]
    3 
     1[[TranslatedPages]]
     2[[TOC(sectionindex, heading=ARexx Function List, notitle, depth=1, Documentation/ARexxAPI/)]]
    43== REQUESTFILE
    54
    6 '''NAME'''
     5 NAME::
    76     RequestFile -- Request the user to select a file.  (V2.6)
    87
    9 '''TEMPLATE'''
     8 TEMPLATE::
    109     VAR/K,STEM/K,TITLE/A,DRAWER,FILE,MULTISELECT/S,DRAWERSONLY/S,SAVEMODE/S,NOICONS/S
    1110
    12 '''FUNCTION'''
     11 FUNCTION::
    1312     Requests the user to select a file.
    1413
    15 '''INPUTS'''
    16      VAR/K             - alternative variable to put the results into instead of RESULT\\
    17      STEM/K            - base name used for the stem where the result will be stored\\
    18      TITLE/A           - the title of the file requester\\
    19      DRAWER            - initial drawer when opening the requester\\
    20      FILE              - initial file when opening the requester\\
    21      MULTISELECT/S     - enable multiselection\\
    22      DRAWERSONLY/S     - exclude files from selection\\
    23      SAVEMODE/S        - set requester to "save mode", no selection via doubleclick will be possible then\\
    24      NOICONS/S         - hide icon files\\
     14 INPUTS::
     15     `VAR/K`             - alternative variable to put the results into instead of `RESULT`\\
     16     `STEM/K`            - base name used for the stem where the result will be stored\\
     17     `TITLE/A`           - the title of the file requester\\
     18     `DRAWER`            - initial drawer when opening the requester\\
     19     `FILE`              - initial file when opening the requester\\
     20     `MULTISELECT/S`     - enable multiselection\\
     21     `DRAWERSONLY/S`     - exclude files from selection\\
     22     `SAVEMODE/S`       - set requester to "save mode", no selection via doubleclick will be possible then\\
     23     `NOICONS/S`         - hide icon files\\
    2524
    26 '''RETURNS'''
    27      VAR          - info returned by the query\\
    28      <STEM>DRAWER - name of the selected drawer\\
    29      <STEM>FILES  - names of the selected files\\
     25 RETURNS::
     26     `VAR`          - info returned by the query\\
     27     `<STEM>DRAWER` - name of the selected drawer\\
     28     `<STEM>FILES`  - names of the selected files\\
    3029
    31      RC is set to 1 if the user cancels the requester.
     30     `RC` is set to 1 if the user cancels the requester.
    3231
    33 '''NOTES'''
     32 NOTES::
    3433
    35 '''EXAMPLE'''
    36          /* Enable result codes */\\
    37          OPTIONS RESULTS
     34 EXAMPLE::
     35     {{{#!arexx
     36     /* Enable result codes */
     37     OPTIONS RESULTS
    3838
    39          REQUESTFILE title="Please select a file" drawer="RAM:" STEM files.
     39     REQUESTFILE title="Please select a file" drawer="RAM:" STEM files.
    4040
    41          IF RC~= 0 THEN EXIT
     41     /* Only continue if RC == 0 */
     42     IF RC ~= 0 THEN EXIT
    4243
    43          SAY "selected drawer is '" files.drawer "'"\\
    44          DO i=0 to files.COUNT-1\\
    45            SAY "selected file '" files.files.i "'"\\
    46          END\\
     44     SAY "selected drawer is '" files.drawer "'"
     45     DO i=0 to files.COUNT-1
     46       SAY "selected file '" files.files.i "'"
     47     END
     48     }}}
    4749
    48 '''BUGS'''
     50 BUGS::
    4951
    50 '''SEE ALSO'''
     52 SEE ALSO::