

            REQUESTCHOICE (3.x only, located in C:)

       NAME
            Requestchoice - Adds a decision requestor to an 
        AmigaDOS script file or AREXX script.

       SYNOPSIS
            Requestchoice titlebox bodytext buttontext(s) 
        [PUBSCREEN screenname]

       DESCRIPTION
            When the requestor window opens and lets the user 
        chose from one or more buttons. When a button is chosen, 
        the number of that button is returned.

       KEYWORDS

        titletext
            The text you want in the title bar of the window. It 
        is a good idea to have this title bar mention where the 
        window was launched from so that the user won't get 
        confused. You must always include titletext. If you don't 
        want to have text in your titlebar, then use a blank text 
        string (""). 

        bodytext
            This is the main body text of the window. (for 
        example "Do you wish to continue?"). This string is also 
        required.

        buttontext(s)
            This assigns the words to the button choices. You 
        must have atleast one button. Extra buttons may be added 
        by just tacking on extra text screens. Every button is 
        assigned a number, when a button is chosen b the user, 
        the command returns this number to the console. If there 
        are text for many buttons, they will appear from left to 
        right. The button on the leftmost is number 1, the next 
        is number 2, and so on. The only exception is the last 
        button entered which is assigned the number of zero. This 
        is reserved for the "Cancel", "No", or "Quit" optons.

        [PUBSCREEN screenname]
            This lets you place your requestor on any public 
        screen by adding this keyword with the name of the 
        screen.


        EXAMPLES

            1. Print the number in the shell window the user 
        selects from the requestor:

  SET Number 'REQUESTCHOICE " " "Pick your number" 1 2 3 4 5 0'
  ECHO "You chose the number $Number"


            2. Ask the user to continue or quit:

    SET Continue 'REQUESTCHOICE Script "Continue???" Yes No'
       IF VAL $Continue EQ 0
       ECHO "You're outta here!"
       QUIT
       ENDIF
    ECHO "Next command??"
