wn_input_string_dialog_c

	status.i4.v = wn_input_string_dialog_c(x.r8.v, y.r8.v,
					       coordinate_type.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.d]
					       [,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 wn_inptxt_c
	except that this routine supports horizontally scrolling text
	fields.

	x		x location of the upper left hand corner of the
			window relative to the parent graphic window
	y		y location of the upper left hand corner of the
			window relative to the parent graphic window
	coordinate_type	type of coordinate values passed
			(WN_WORLD_COORDS -> normal window world coordinates,
			 WN_PIXEL_COORDS -> raw pixel coordinates)
	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 CLIB_DEFAULT_ARG which sets the number
			 of lines equal to the number of strings to 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:

	wn_inptxt_c, input_string_dialog_c, 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		coordinate_type = WN_PIXEL_COORDS;
	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;
	double		x = 0;
	double		y = 0;
	HELP_CALLBACK_DATA	*help_info = (HELP_CALLBACK_DATA *) NULL;

	status = wn_input_string_dialog_c(x,y,coordinate_type,prompt_text,
					  num_chars,(char *) strings,max_length,
					  display_length,num_values,title,
					  num_lines,key_case,key_color,
					  help_info);