Read_Select


Purpose   Displays a horizontal or vertical list of choices.

Decln.    Read_Select(X,Y:byte;Prompt,Txt:StrScreen;var Choice:byte);

Remarks   X, Y are the coordinates of the first character of the prompt or
          the first character of the input field if the prompt is null.
          Prompt is an optional prompt. The prompt is normally displayed to
          the left of the input field. If the prompt begins with a carat
          '' and the box border is on, the prompt is drawn in the upper
          box border. If the prompt begins with an underscore '_' and the
          box border is on, the prompt is drawn in the lower box border.
          Set the prompt to a null '' if no prompt is required.
          Txt is a string containing the list of choices. Each choice is
          separated by a space. If a choice is composed of more than one
          word, the words must be connected with the underscore '_'
          character. By default, the choices list is displayed horizontally
          across the screen. However, if the first character in the choices
          string is a carat '', the list is displayed vertically.
          Choice is a byte variable that is updated with the value of the
          user's selected choice.

          The display characteristics of the input line are contained in
          the global variable RTTT.

          The global variable R_Char is updated with the last character
          pressed by the user. This can be checked to see how the user
          terminated input, e.g. Esc, Up Arrow, etc.

Example

VAR
   VAR PICK : BYTE;
BEGIN
    READ_SELECT(10,5,'HOW YA DOIN','COOL OK BAD WILD FOXY',PICK);
END;