[<<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