[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 _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 zero to _gtMaxRow().  uiCol may be in the
     range of zero 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.


See Also: _gtGetPos() _gtSetPos() _gtWrite() _gtWriteCon()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson