Writing a String at a Specified Location

Moving the virtual cursor to a specific location and then writing a string can be done with one call to the video string place function, v_stpl():

UCHAR *v_stpl(wn_row, wn_col, stp, wnp)

int wn_row;

/* Row of window to start writing at

*/

int wn_col;

/* Column of window to start writing at

*/

UCHAR *stp;

/* String to write

*/

WINDOWPTR wnp;

/* Pointer to window to write in

*/

This function first changes the location of the virtual cursor to the specified row and column. Then, the string is written using v_st(). The virtual cursor is advanced to the position after the last character written if the virtual cursor advance option is ON.

A NULLP is returned if the end of the string is reached. If the full string was not written, a pointer to the next character in the string is returned. If you want to finish writing the string, you can use this pointer as the next string to write to the window.