horz_scrolling_text_message_c

	status.i4.v = horz_scrolling_text_message_c(top_row.i4.v,
						    left_column.i4.v,
						    num_columns.i4.v,
						    text.i1a.r,
						    text_length.i4.v,
						    exit_switch.i4.v
						    [,resize_screen.i4.v]
						    [,title.i1a.r]
						    [,synchronous.i4.v]
						    [,text_color.i4.v])

	This routine will display a horizontally scrolling message window.

	top_row		top row of window (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	left_column	left column of window (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	num_columns	number of columns of text to display (>= 1)
	text		text to display
	text_length	text length (If a value of 0 is passed for this
			argument, this routine will determine the length
			of the text.)
	exit_switch	determine whether or not to display an exit switch
			(Note: This argument has no effect if "synchronous"
			 has a value of FALSE.)
			(TRUE -> display exit ("OK") switch,
			 FALSE -> no exit switch)
	[resize_screen]	determine whether or not to resize the background
			window to accommodate this window
			(Note: This argument has no effect if "synchronous"
			 has a value of FALSE.)
			(TRUE -> resize screen to fit large windows (default),
			 FALSE -> don't resize screen)
	[title]		window title (A value of NULL can be passed for this
			argument if no title is desired.)
			(default is NULL)
	[synchronous]	declares the handling of the window
			(TRUE -> window will remain open until closed by user
				 action and then control will return to
				 the caller (default),
			 FALSE -> routine will return immediately after
				  drawing the window and will return the
				  window ID for deletion by the caller)
	[text_color]	text color (constants are in cnsparam)
			(default is GREEN)

	This function returns status values as follows:

	OK			success
	CBS_INVARG		invalid number of columns
	CBS_WINDOW_TOO_BIG	message window won't fit on the TV screen
	CBS_INVSIZ		image is too large for TV screen
	otherwise		window ID if asynchronous mode is selected

	This function requires the following include files:

	cnsparam_h, cbslib_h, macro_h, acnet_errors_h

	Related functions:

	text_message_c, xchar_text_message_c, tvmess(_c), timmes(_c),
	post_message(_c), meswin(_c), window_tvdisp(_c), dialog_setup_c,
	window_restore_hint_c

	C/C++ usage:

	static const char	text[] =
	"This is a scrolling text message to display.";
	static const char	title[] = "Title";
	int	status;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	int	num_columns = NUM_COLUMNS;
	int	text_length = 0;
	int	exit_switch = TRUE;
	int	resize_screen = TRUE;
	int	synchronous = TRUE;
	int	text_color = CYAN;

	status = horz_scrolling_text_message_c(top_row,left_column,num_columns,
					       text,text_length,exit_switch,
					       resize_screen,title,synchronous,
					       text_color);