[Contents] [Index] [Help] [Browse <] [Browse >]

 -- Command: request ID/K, TITLE/K, GADGETS/K, FILE/K, STRING/F
     This command will bring up a standard `MUI' requester.  Note that
     this command is syncronous.  That is once it is issued it will not
     return a result until the user has selected a gadget.  Once a
     gadget has been selected then a number will be returned in the
     `ARexx' variable RESULT (assuming `options results' was specified
     in the script). The first gadget will return a 1, the second a 2,
     and so on.  The last gadget, however, will return a 0 (this is by
     convention since the last gadget is typically a CANCEL or
     equivilent gadget).

        * ID - this argument specifies a window ID.  If specified then
          the requester will be centered in the window.

        * TITLE - this argument specifies the requester title (placed
          in the title bar of the requester window).

        * GADGETS - this argument specifies the gadget labels.  The
          labels are given as a single string with a vertical bar, |
          used to separate each label.  Additionally, each label can
          contain an underscore, _ prior to any character.  The
          character will be the keyboard shortcut to activate the
          associated gadget.

        * FILE - if given, this argument specifies the file to get the
          contents for the requester.  All line breaks in the file will
          be included.  Note that this argument overrides the STRING
          argument.

        * STRING - this argument specifies the string to display in the
          requester.

     Example use of this command:

          request ID MDIR GADGETS '"OK|Cancel"' '"Delete selected entries?"'