Changes between Initial Version and Version 1 of Documentation/ARexxAPI/REQUEST


Ignore:
Timestamp:
Sep 23, 2013, 8:56:28 PM (15 months ago)
Author:
AmigaPhil
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/ARexxAPI/REQUEST

    v1 v1  
     1== REQUEST
     2
     3'''NAME'''
     4     Request -- Open a custom requester.  (V1.3.3)
     5
     6'''TEMPLATE'''
     7     VAR/K,STEM/K,BODY/A,GADGETS/A
     8
     9'''FUNCTION'''
     10     Opens a requester containing the supplied body and gadgets, and
     11     returns the choice taken by the user.
     12
     13'''INPUTS'''
     14     VAR/K       - alternative variable to put the results into instead of RESULT  (V2.0)\\
     15     STEM/K      - base name used for the stem where the result will be stored  (V2.0)\\
     16     BODY/A      - a string containing the body of the requester\\
     17     GADGETS/A   - a string containing a vertical bar ("|") separated list of gadget labels\\
     18
     19'''RETURNS'''
     20     VAR          - info returned by the query\\
     21     <STEM>RESULT - number of the selected gadget; may be 0 for the rightmost gadget, 1 for the leftmost gadget, and 2..n for the second, etc. gadget from the left\\
     22
     23'''NOTES'''
     24     Following the MUI specs, every gadget can have a shortcut by
     25     inserting a '_' (underscore) character in front of the character
     26     that should be used as shortcut.  A default gadget can also be
     27     defined with a '*' (asterisk) character in front; the default
     28     gadget is activated when pressing the <Return> key.
     29
     30     Styles can also be used.  See the MUI developer documentation
     31     for more info.
     32
     33     Please respect the Amiga User Interface Style Guide when creating
     34     requesters.  For instance, the rightmost gadget will be triggered
     35     by the <Esc> key, and should always offer a safe way out.
     36
     37'''EXAMPLE'''
     38         /* Enable result codes */\\
     39         OPTIONS RESULTS
     40
     41         /* Prepare the text for our requester.\\
     42         !* Here we have to escape the single '*' (asterisk) via\\
     43         !* an additional asterisk sign because an asterisk is\\
     44         !* a reserved character for ARexx itself\\
     45         */\\
     46         body = '"Isn't YAM just great?"'\\
     47         gadgets = '"!**_Yeah!|_No way, Outlook rules!|_What is YAM?"'\\
     48
     49         /* Open a custom requester */\\
     50         REQUEST body gadgets\\
     51
     52'''BUGS'''
     53
     54'''SEE ALSO'''