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

 _gtWriteAt()
 Write a string at the specified screen location
------------------------------------------------------------------------------
 C Prototype

     #include "gt.api"
     ERRCODE _gtWriteAt(
                         USHORT uiRow,
                         USHORT uiCol,
                         BYTEP fpStr,
                         USHORT uiLen
                       )

 Arguments

     uiRow and uiCol are the screen coordinates at which to write the string.
     uiRow may be in the range of 0 to _gtMaxRow().  uiCol may be in the
     range of 0 to _gtMaxCol().

     fpStr is the string to write.

     uiLen is the length of the string.

 Returns

     _gtWriteAt() returns zero if successful.  Any other value indicates an
     error.

 Description

     _gtWriteAt() writes a string to the screen at the specified coordinates.
     After the string is written, the internal row and column coordinates are
     updated so the CA-Clipper functions, ROW() and COL() will reflect the
     new cursor position.

 Examples

     .  In this example, the function PrintStr() uses _gtWriteAt() to
        display a NULL terminated string in a specified color:

        #include "gt.api"

        void PrintStr( USHORT uiRow, USHORT uiCol, BYTEP fpStr,
                       BYTEP fpColor );

        void PrintStr( USHORT uiRow, USHORT uiCol, BYTEP fpStr,
                       BYTEP fpColor )
        {
           _gtSetColorStr( fpColor );
           _gtWriteAt( uiRow, uiCol, fpStr, strlen( fpStr ) );
        }

 Files:  Library is CLIPPER.LIB, header file is Gt.api.