[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 _gtWrite()
 Write a string to the current screen location
------------------------------------------------------------------------------
 C Prototype

     #include "gt.api"
     ERRCODE _gtWrite(
                       BYTEP fpStr,
                       USHORT uiLen
                     )

 Arguments

     fpStr is the string to write.

     uiLen is the length of the string.

 Returns

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

 Description

     _gtWrite() displays a string to the screen at the current cursor
     location.  The internal row and column coordinates are updated so the
     CA-Clipper functions, ROW() and COL() will reflect the new cursor
     position.

 Examples

     .  This example creates a simple function that displays a
        null-terminated string at a specific screen location:

        #include "gt.api"

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

        void PrintStr( USHORT uiRow, USHORT uiCol, BYTEP fpStr )
        {
           _gtSetPos( uiRow, uiCol );               // Set new position
           _gtWrite( fpStr, strlen( fpStr ) );      // Write string
           return;
        }

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


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