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

 _gtRepChar()
 Replicate a character to the screen
------------------------------------------------------------------------------
 C Prototype

     #include "gt.api"
     ERRCODE _gtRepChar(
                         USHORT uiRow,
                         USHORT uiCol,
                         USHORT uiChar,
                         USHORT uiCount
                       )

 Arguments

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

     uiChar is the ASCII value of the character to replicate.

     uiCount is the number of times to replicate the character.

 Returns

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

 Description

     _gtRepChar() lets you replicate a single character to the screen a
     specified number of times.  The row that you specify stays the same
     while the column position is incremented by one for each replication of
     the character.  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, _gtRepChar() draws a single-line horizontal
        divider:

        #include "gt.api"

        #define HBAR_LEFT    195
        #define HBAR_MIDDLE  196
        #define HBAR_RIGHT   180

        void drawHBarS( USHORT uiR, USHORT uiL, USHORT uiW );

        void drawHBarS( USHORT uiR, USHORT uiL, USHORT uiW )
        {
           _gtWriteAt( uiR, uiL, HBAR_LEFT );
           _gtRepChar( uiR, uiL + 1, HBAR_MIDDLE, uiW - 2 );
           _gtWrite( HBAR_RIGHT );
        }

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