Writing a String Using a New Attribute

The video string attribute function, v_statt(), writes a string using the attribute specified in the call. The format of the call is as follows:

UCHAR *v_statt(stp, att, wnp)

UCHAR *stp;

/* String to be written

*/

UCHAR att;

/* Attribute to write string with

*/

WINDOWPTR wnp;

/* Pointer to window to write in

*/

v_statt() writes output beginning at the location of the virtual cursor. Output stays within the window's buffer. v_statt() respects all option settings for window writing. If the clear-to-end-of-row option is ON, the spaces written to the end of the row are written using the window attribute, not the attribute specified in the call.

A NULLP is returned if the end of the string was 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.