Click above to get retro games delivered to your door ever month!

   tp_tflags() - get or set terminal emulator flags

   nOldFlags := tp_tflags([nNewFlags])

   nNewFlags   New emulator flags.

   Returns     Original emulator flags.

   Gets or sets the terminal emulator control flags.  These flags may be
   set either before calling a terminal emulator, or from within the
   exception handler while it is running.  The flags, nOldFlags and
   nNewFlags, are produced by adding together zero or more of the
   following values:

       Value       Name            Meaning
       ----------------------------------------------------------------
          1        TF_ECHO         Local echo.  Characters sent from the
                                   keyboard or by tp_tsend() are echoed
                                   locally.
          2        TF_ECTRL        Echo controls as "^X".  Control
                                   characters (other than those that the
                                   emulator recognizes and handles
                                   specially) are echoed as a "^"
                                   followed by a single character.
          4        TF_DESTR        Destructive backspace.  Backspace
                                   erases the character it overwrites.
          8        TF_ADDLF        Add line feed to carriage return when
                                   displaying input or local-echo
                                   output.
         16        TF_DEL          The backspace key on the keyboard
                                   sends DEL, chr(127), instead of BS,
                                   chr(8).
         32        TF_NOSEND       Do not send.  The emulator does not
                                   read the keyboard.  Any output will
                                   be generated by the exception
                                   handler.
         64        TF_NORECV       Do not receive.  The emulator does
                                   not read serial input.  Any input
                                   must be handled by the exception
                                   handler.
        128        TF_SNOW         Obsolete, ignored.
        256        TF_BIOS         Obsolete, ignored.
        512        TF_QUIET        No bells.  ^G, which normally sounds
                                   the terminal bell, does nothing.
       1024        TF_NOWRAP       Do not wrap at end of line.  If a
                                   character is printed in the last
                                   position on a line, the cursor stays
                                   in that position, instead of moving
                                   to the next line.
       2048        TF_COLOR        Send a TTY_COLOR message to the
                                   exception handler when the emulator's
                                   display color changes because of a
                                   received control sequence.

   [5.0] In Clipper 5.0, the constants in the "Name" column are defined
   in the telepath.ch header file.

   If nNewFlags is omitted, tp_tflags() just returns the current
   setting.  If nNewFlags is specified, it changes the settings and
   returns the original value.


   Example:

       #include "telepath.ch"

       tp_tflags(TF_DESTR)