hilite_simple_row_create_c

	status.i4.v = hilite_simple_row_create_c(window_id.i2.v, top_row.i4.v,
						 left_column.i4.v,
						 num_rows.i4.v,
						 num_chars.i4.v,
						 color.i4.v,
						 auto_update.i4.v,
						 hilite_id.i2.r
						 [,update_func.f.v]
						 [,update_data.g.v])

	This routine will create a highlighting region on the TV screen
	which can be serviced by subsequent calls to 'hilite_update_c'.
	This highlighting region remains active until it is removed by
	calling 'hilite_delete_c'.  (Note: When using this routine, the
	default window repaint mode should be set to WMNGR_REPAINT by a
	call to 'window_restore_hint_c'.)  All highlight regions in a
	window are automatically deleted when the window is deleted.

	window_id	window ID for window containing the highlight region
			(use WMNGR_BACKGROUND for background window)
	top_row		top row of highlight region
	left_column	left column of highlight region
	num_rows	number of highlight rows
	num_chars	number of characters in a highlight item
	color		highlighting color (default is HILITE_DEFAULT_COLOR)
			(constants are in cnsparam)
	auto_update	flag to determine whether to automatically update
			(TRUE -> automatically update this highlight region,
			 FALSE -> update by calls to 'hilite_update_c')
	hilite_id	returned highlight ID
	[update_func]	callback function to be called just before updating
			a new region in auto update mode
			(called as follows:
			 suppress_update.i4.v = update_func(window_id.i2.v,
							    update_data.g.v,
							    hilite_data.s.r)
			("hilite_data" is a structure of type HILITE_UPDATE_DATA)
			(A value of NULL can be passed for this argument
			 if this functionality is not desired.)
	[update_data]	address of data to be passed to "update_func"

	This function returns ACNET status values as follows:

	CBS_OK			success
	CBS_NO_SUCH		requested window does not exist
	CBS_INVARG		invalid rows and/or columns
	CBS_MEMFAIL		failed in allocating dynamic memory

	This function requires the following include files:

	cnsparam_h, cbslib_h, acnet_errors_h

	Related functions:

	hilite_create_c, hilite_update_c, hilite_delete_c,
	hilite_window_delete_c, hilite_suspend_c, hilite_resume_c,
	window_hilite_c, window_hilite_line_c, window_restore_hint_c,
	hilite_modify_save_buffer_c

	C/C++ usage:

	short	window_id = WMNGR_BACKGROUND;
	short	hilite_id;
	int	status;
	int	top_row = 3;
	int	left_column = 1;
	int	num_rows = NUM_ROWS;
	int	num_chars = NUM_CHARS;
	int	color = HILITE_DEFAULT_COLOR;
	int	auto_update = TRUE;
	void	*update_data = (void *) NULL;
	int	update_func(short window_id, void *update_data,
			    HILITE_UPDATE_DATA *hilite_data);

	status = hilite_simple_row_create_c(window_id,top_row,left_column,
					    num_rows,num_chars,color,
					    auto_update,&hilite_id,
					    update_func,update_data);