IO_DefineStr                                                     IOTTT



Purpose   To define all the characteristics of a specific input field.
          This is the major procedure in the IOTTT unit.

Type Mandatory

Declaration    IO_DefineStr(ID,
               U,D,L,R,
               X,Y: byte;
               var DefString : string;
               DefFormat     : string);

           See Remarks.

Uses CRT, FastTTT, DOS, WinTTT, KeyTTT, IOTTT.

Remarks   ID is the ID number for this input field. Every field is
          assigned an ID number, the same ID number is used by the
          IO_DefineMsg procedure. It is logical (but not mandatory) to
          start with ID number 1 and increment by one as you define
          each field.

          U,D,L,R are four bytes which represent the ID's of the
          fields which the cursor should move to if the up, down, left
          or right edit keys respectively are pressed, . For example,
          5,2,5,2    would state that if the up or left keys are
          pressed, the cursor will move to field ID 5, and if the down
          or right keys are pressed, the cursor will move to field ID
          2. Got it? Note that an ID of zero (0) indicates that the
          input session will terminate (as if the End key had been
          pressed). This is a useful tool if you want to end a session
          after the last field has been updated and the user tries to
          move forward to the next input field.

          X,Y simply represent the X and Y coordinates of the first
          character in the input field. This is how you tell the
          system the location of the field on the screen.

          DefString is a previously declared parameter of type string
          which is returned from the IO procedure with the user's
          input. If you want to provide the user with a default entry,
          then set the value of DefString to the required default
          string, otherwise set it to null i.e. ''.

          DefFormat which is the format of the input field (as
          discussed previously under the sub-heading FORMATTING).

Example   See Major example on page 64.