input_string_dialog_c

	status.i4.v = input_string_dialog_c(top_row.i4.v, left_column.i4.v,
					    prompt_text.i1a.r, num_chars.i4.v,
					    strings.i1a.r, max_length.i4.v
					    display_length.i4.v
					    [,num_values.i4.v]
			 		    [,title.i1a.r] [,num_lines.i4.v]
					    [,key_case.i4.v] [,key_color.i4.v]
					    [,help_info.sa.r])

	This routine will prompt the user to input a text string or an
	array of strings by creating a window and displaying a prompt.
	It then waits until the user interrupts, deletes the window, and
	returns the text string(s) to the caller.  The length of the longest
	string input is returned.  This routine is like inptxt(_c)
	except that this routine supports horizontally scrolling text
	fields.

	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)
	prompt_text	prompt text string(s) ("num_values" strings)
	num_chars	number of characters in each prompt string
			(If a value of zero is passed for this argument,
			the routine will automatically determine the prompt
			text length.)
	strings		returned null terminated text string(s)
			(If the strings passed into this routine are not
			 null strings, they will be displayed.)
	max_length	maximum length of returned text string not
			counting the null terminator
	display_length	number of characters to display at a time
	[num_values]	number of strings to input (default is 1)
	[title]		optional window title (default (NULL) is no title)
	[num_lines]	number of lines of input to be displayed at a
			time (default is the number of strings to be input)
	[key_case]	controls case of typed characters
			(WMNGR_UPPER_CASE -> only upper case displayed,
			 WMNGR_MIXED_CASE -> allows lower case (default))
	[key_color]	color of echoed characters (default is RED)
	[help_info]	entry by entry help callback information
			(array of HELP_CALLBACK_DATA structures)
			(default is NULL)

	This function returns status values as follows:

	CBS_INVARG		requested string length is too long
				or invalid number of strings
	CBS_WINDOW_TOO_BIG	window won't fit on the screen
	CBS_MEMFAIL		dynamic memory allocation failure
	CBS_ABORT		user aborted input (no values were changed)
	otherwise		length of (longest) input string

	This function requires the following include files:

	cnsparam_h, cbslib_h, clib_h, macro_h, acnet_errors_h

	Related functions:

	inptxt(_c), text_edit_window_c, text_edit_dialog_c, cns_edit,
	window_edit_c, winput(_c), window_input_value(_c), dialog_setup_c,
	window_restore_hint_c

	C/C++ usage:

	static char	title[] = "Title";
	static char	prompt_text[] = "String 1String 2String 3";
	char		strings[NUM_STRINGS][STRING_LENGTH+1];
	int		status;
	int		top_row = WMNGR_CENTER;
	int		left_column = WMNGR_CENTER;
	int		num_chars = 0;
	int		max_length = STRING_LENGTH;
	int		display_length = DISPLAY_LENGTH;
	int		num_values = NUM_STRINGS;
	int		num_lines = NUM_STRINGS;
	int		key_case = WMNGR_MIXED_CASE;
	int		key_color = RED;
	HELP_CALLBACK_DATA	*help_info = (HELP_CALLBACK_DATA *) NULL;

	status = input_string_dialog_c(top_row,left_column,prompt_text,
				       num_chars,(char *) strings,max_length,
				       display_length,num_values,title,
				       num_lines,key_case,key_color,help_info);