window_read_color_text_c

	num_read.i4.v = window_read_color_text_c(window_id.i2.v, row.i4.v,
						 column.i4.v, text.sa.r,
						 num_chars.i4.v)

	This routine reads color-coded text from the specified window.
	Character attributes (colors and blink) are specified for each
	character individually.  This routine will return the number
	of characters actually read.  (Note: If scroll buffer I/O is
	enabled for this window, a negative row value will allow reading
	text from the scroll buffer above the window, and a row value
	greater than the size of the window will allow reading from the
	scroll buffer below the window.)

	window_id	window ID (use WMNGR_BACKGROUND for background window)
	row		window row
	column		starting column
	text		user buffer of ASCII data and character attributes
			to be filled by this routine, one character per word.
			The low byte of each word contains an ASCII character,
			and the high byte contains the display attributes for
			the character.  (Note: This text reflects what is
			stored in memory for this window and may not reflect
			characters typed in by the user in the case of an
			occluded window.) (array of XCHAR structures)
	num_chars	number of characters

	This function returns status values as follows:

	CBS_INVARG		invalid number of characters
	CBS_NO_WINDOW		requested window does not exist
	otherwise		number of characters actually read

	This function requires the following include files:

	cns_data_structs_h, cbslib_h, acnet_errors_h

	Related functions:

	window_read_text_c, window_tvmx(_c), window_tvm(_c),
	window_entry_to_row_c, window_physical_column_c, intro_tv_windows

	C/C++ usage:

	short	window_id;
	int	num_read;
	int	row = 1;
	int	column = 1;
	int	num_chars = NUM_CHARS;
	XCHAR	text[NUM_CHARS];

	num_read = window_read_color_text_c(window_id,row,column,
					    text,num_chars);